orchestration

🎭 Orchestration Plugin for Claude Code

Like N8N in Claude Code

If you like the project, consider ⭐ it!

---

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.

Community Workflow Registry (The "NPM" for Agents)

Stop writing workflows from scratch. Pull proven architectures from the community registry directly into your workspace.

# Pull from the official registry
/orchestration:pull tdd-autopilot