Claude Code Plugin
Run Supaflow from Claude Code™
Use Claude to create datasources, build pipelines, run syncs, and manage schedules in Supaflow without hand-writing CLI commands.
If you have ever asked an AI agent to help with pipeline setup and watched it guess flags, field names, or shell steps, this plugin is the safer version of that workflow. It gives Claude a narrow, explicit surface area for real Supaflow tasks so you get the speed of chat with the reliability of the Supaflow CLI.
What You Can Do With It
The plugin is meant for practical day-to-day pipeline work. It helps Claude stay useful when you need to create, inspect, run, or schedule real Supaflow resources.
Create datasources
Connect a source or destination from Claude Code using the same Supaflow CLI workflow you would run manually.
Build pipelines
Ask Claude to set up a new pipeline, choose objects, and confirm the final configuration before anything is created.
Run and monitor syncs
Start a sync, check job status, and inspect failures without bouncing between docs, terminal history, and dashboards.
Schedule recurring loads
Add or update a schedule from chat once the pipeline is working and you are ready to automate it.
Stay inside guardrails
The plugin limits Claude to approved commands and validates setup at session start so it does less improvising.
Fork the plugin
The project is open source, so you can inspect how it works or reuse the same pattern for your own CLI-based workflows.
Why this plugin exists
Claude is good at turning intent into a sequence of steps. It is not good at being trusted with invented flags, guessed field names, or one-off shell scripts. That is where most AI-assisted CLI workflows break down.
This plugin gives Claude a small, explicit surface area for Supaflow tasks. Instead of asking the model to improvise commands, it routes work through known workflows for datasources, pipelines, syncs, schedules, and job inspection.
Supaflow still handles authentication, execution, retries, and pipeline state. Claude just helps you move through the workflow faster and with less context switching.
Typical Workflows
These are the kinds of tasks where the plugin is most useful: enough structure to be safe, but still conversational enough to move faster than typing everything by hand.
Set up a new warehouse sync
Ask Claude to connect a source and destination, build the pipeline, and walk you through the confirmation steps.
Reconnect a broken datasource
Use the plugin to inspect the existing setup, update credentials or settings, and retry without hunting through old terminal commands.
Check why a job failed
Ask Claude to check recent runs, inspect job status, and narrow down whether the issue is configuration, schema drift, or a source-side problem.
Schedule a pipeline after validation
Once the initial sync is healthy, have Claude add a recurring schedule instead of manually composing another CLI command.
Why It Works Better Than Free-Form AI CLI Usage
Claude helps with reasoning, Supaflow handles execution
The plugin is built for teams who want conversational help during setup and operations, but do not want the model inventing the operational layer.
Real commands are safer than generated shell snippets
Command guardrails, confirmation steps, and setup checks reduce the common failure modes in raw AI-CLI usage: guessed flags, wrong command routing, and skipped prerequisites.
You can learn the workflow while using it
Because the plugin follows explicit Supaflow workflows, the page works as both a productivity tool and a lightweight teaching tool for how Supaflow operations actually fit together.
Get Started
Add the plugin to Claude Code and start a session. The plugin checks for CLI installation, authentication, and workspace selection automatically on first run.
1. Clone the plugin
2. Add it to Claude Code
3. Start Claude Code
The plugin loads automatically. If the Supaflow CLI is not installed, authenticated, or pointed at the right workspace, the plugin walks you through setup before you start making changes. Try a command like /create-pipeline or ask Claude to build a pipeline from one system to another.
View CLI docs for how to create an API key and authenticate from the CLI.
Frequently Asked Questions
A few practical questions that usually come up before teams start using the plugin in real workflow conversations.