🎭 Orchestration Plugin for Claude Code
Like N8N in Claude Code
If you like the project, consider ⭐ it!
Advertisment
Check out my new SaaS VideoEffectVibe - turn prompts into editable, configurable overlays, texts, lower thirds. Forget boring templates, make it custom and yours, from just a prompt!
Video Effect Vibe - Click to go to the website
Multi-agent workflow orchestration. Chain AI agents to automate complex tasks using natural language or declarative syntax.
Contributing
Feel free to open a PR and contribute to the project!
Installation
1. Add Plugin Marketplace
First, add the orchestration marketplace to your Claude Code:
/plugin marketplace add mbruhler/claude-orchestration
2. Install the Plugin
/plugin install orchestration@mbruhler
Or use the interactive menu:
/plugin
Then select "Browse Plugins" → find orchestration → Install
3. Verify Installation
Check that the plugin is installed:
/help
You should see orchestration commands like /orchestration:menu, /orchestration:init, etc.
Quick Start
0. Import Your Custom Agents (Optional)
/orchestration:init
Import your custom agents from ~/.claude/agents/ into the orchestration plugin.
Example:
/orchestration:init
→ Select agents to import
→ Agents become available as expert-code-implementer, etc. and the plugin can create workflows using them
1. Natural Language
"Create a workflow that fetches 10 Reddit posts about startups,
analyzes competition, and shows a ratings table"
The plugin:
- ✅ Creates necessary temp scripts (Python/Node.js)
- ✅ Guides you through clickable questions
- ✅ Generates and executes optimized workflow
- ✅ Returns formatted results
2. Direct Syntax
# Parallel bug investigation
[
Explore:"Find related code":code ||
general-purpose:"Check recent changes":changes ||
general-purpose:"Search similar issues":similar
] ->
general-purpose:"Identify root cause from {code}, {changes}, {similar}":analysis ->
@review:"Approve fix?" ->
general-purpose:"Implement fix and run tests":fix ->
general-purpose:"Commit changes with detailed message"
3. Templates
"Use the TDD implementation template"
Core Features
Flow Control
# Sequential
step1 -> step2 -> step3
# Parallel
[task1 || task2 || task3]
# Conditional
test -> (if passed)~> deploy
-> (if failed)~> rollback
Auto Temp Scripts
Automatically creates Python/Node.js scripts for:
- 🌐 Web scraping (BeautifulSoup, Selenium)
- 📡 APIs (Reddit, Twitter, GitHub)
- 📊 Data processing (pandas, NumPy)
- 🗄️ Database queries
Manual Checkpoints
build:"Compile app" ->
@review:"Check output. Continue?" ->
deploy:"Deploy to production"
Visual Progress
╔════════════════════════════════════╗
║ TDD Implementation ║
╠════════════════════════════════════╣
║ [Write Test] ● ║
║ │ ║
║ [Implement] ○ ║
║ │ ║
║ [@Review] ○ ║
╠════════════════════════════════════╣
║ Status: Writing test... ║
╚════════════════════════════════════╝
⏰ Autonomous Scheduling & Headless Mode
With Claude Code's native /loop and Desktop Scheduling tools, your workflows don't have to be run manually. Turn your orchestrations into autonomous background workers!
Syntax Integration
Add the @schedule directive to the top of your .flow file to instruct Claude to run it repeatedly:
# Runs daily at 8:00 AM automatically
@schedule("0 8 * * *")
[
Explore:"Check recent GitHub PRs":prs ||
general-purpose:"Check open Sentry issues":bugs
] ->
general-purpose:"Draft daily standup summary from {prs} and {bugs}":summary ->
general-purpose:"Append {summary} to standup_log.md"
Unattended Checkpoints
When running in the background, you can't manually approve checkpoints. Use fallback behaviors to keep things moving:
# Skip manual review if running headless/scheduled
@review(fallback=skip):"Approve code changes?"
# Log to a file instead of blocking the terminal
@approval(fallback=notify):"Verify system state"
🛡️ Reliability & Ecosystem (NEW!)
State Snapshots & Recovery
Never lose workflow progress to a rate-limit, crash, or accidental exit. The plugin automatically saves variables and node status to .orchestration/state.json.
If your workflow dies at step 14 of 15, simply tell Claude:
"Resume the orchestration workflow"
It will load the state, skip steps 1-13, inject the variables, and finish step 14.