A community-driven registry for Claude, Cursor, Windsurf, Cline & more. Not affiliated with Anthropic.
Are you the author? Sign in to claim
Multi-agent workflow orchestration plugin for Claude Code
Like N8N in Claude Code
Feel free to open a PR and contribute to the project!
First, add the orchestration marketplace to your Claude Code:
/plugin marketplace add mbruhler/claude-orchestration
/plugin install orchestration@mbruhler
Or use the interactive menu:
/plugin
Then select "Browse Plugins" → find orchestration → Install
Check that the plugin is installed:
/help
You should see orchestration commands like /orchestration:menu, /orchestration:init, etc.
/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
"Create a workflow that fetches 10 Reddit posts about startups,
analyzes competition, and shows a ratings table"
The plugin:
# 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"
"Use the TDD implementation template"
# Sequential
step1 -> step2 -> step3
# Parallel
[task1 || task2 || task3]
# Conditional
test -> (if passed)~> deploy
-> (if failed)~> rollback
Automatically creates Python/Node.js scripts for:
build:"Compile app" ->
@review:"Check output. Continue?" ->
deploy:"Deploy to production"
╔════════════════════════════════════╗
║ TDD Implementation ║
╠════════════════════════════════════╣
║ [Write Test] ● ║
║ │ ║
║ [Implement] ○ ║
║ │ ║
║ [@Review] ○ ║
╠════════════════════════════════════╣
║ Status: Writing test... ║
╚════════════════════════════════════╝
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!
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"
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"
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.
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
# Pull directly from any GitHub repo
/orchestration:pull username/repo/my-workflow.flow
(Want to publish yours? Submit a PR to registry/index.json in this repo!)
Replace rigid text-matching conditions with dynamic, "thinking" trees.
general-purpose:"Read the latest user support ticket":ticket ->
route({ticket}) => [
(if "UI, CSS, or layout bug") ~> frontend-agent:"Fix styling" ||
(if "Database, 500 error, crash") ~> backend-agent:"Fix server"
]
When Claude gets stuck (e.g. Needs an MFA code or Captcha solved), the AI can pause and orchestrate you to help it out, capturing your input as a variable.
@ask-human:"Please solve the Captcha and paste the success token here":token ->
general-purpose:"Resume scraping using {token}"
.flow.test)Test your massive orchestration files without making expensive API calls. Mock your variables in the YAML frontmatter and the CLI will visually trace the execution path based on the mocked data.
| Syntax | Meaning | Example |
|---|---|---|
-> | Sequential | step1 -> step2 |
| ` | ` | |
~> | Conditional | (if passed)~> next |
@label | Checkpoint | @review-code |
:var | Capture output | analyze:"task":result |
{var} | Use variable | "Process {result}" |
$agent | Temp agent | $scanner:"Scan" |
# Run every 6 hours in the background
@schedule("every 6h")
general-purpose:"Create Python PRAW script to fetch 10 r/startups posts.
Return JSON with title, url, description":posts ->
[
general-purpose:"Research competition for post {posts[0]}":a1 ||
general-purpose:"Research competition for post {posts[1]}":a2
] ->
general-purpose:"Rate ideas (1-10) on competition, market, feasibility.
Create markdown table":ratings ->
# Unattended Checkpoint logs to file instead of hanging the scheduler
@review(fallback=notify):"Review {ratings}. Ban any?" ->
general-purpose:"Append top 3 opportunities summary to startup_leads.md"
general-purpose:"Create Python PRAW script to fetch 10 r/startups posts.
Return JSON with title, url, description":posts ->
[
general-purpose:"Research competition for post {posts[0]}":a1 ||
general-purpose:"Research competition for post {posts[1]}":a2 ||
# ... parallel analyses
] ->
general-purpose:"Rate ideas (1-10) on competition, market, feasibility.
Create markdown table":ratings ->
@review:"Review {ratings}. Ban any?" ->
general-purpose:"Generate top 3 opportunities summary"
# RED: Write failing test
general-purpose:"Write failing test for the feature":test ->
general-purpose:"Run test suite - verify it fails":red_result ->
@review-coverage:"Test coverage sufficient?" ->
# GREEN: Minimal implementation
general-purpose:"Write minimal code to pass the test":impl ->
general-purpose:"Run test suite - verify it passes":green_result ->
@review:"Code quality OK?" ->
# REFACTOR: Clean up
general-purpose:"Refactor code and add documentation":refactored ->
general-purpose:"Final test run and commit"
# Parallel investigation
[
Explore:"Find error pattern in codebase":code ||
general-purpose:"Analyze error logs":logs ||
general-purpose:"Check recent commits":commits ||
general-purpose:"Search for similar bugs":known
] ->
# Diagnosis
general-purpose:"Identify root cause from {code}, {logs}, {commits}, {known}":cause ->
@review:"Diagnosis correct?" ->
# Fix with testing
general-purpose:"Write regression test for the bug":test ->
general-purpose:"Implement fix":fix ->
# Verification
[
general-purpose:"Run regression test" ||
general-purpose:"Run full test suite" ||
general-purpose:"Perform smoke test"
] ->
@review:"Approve deployment?" ->
general-purpose:"Commit with detailed bug fix message"
orchestration/
├── skills/ # Auto-activating skills
│ ├── creating-workflows/
│ ├── executing-workflows/
│ ├── managing-agents/
│ ├── managing-temp-scripts/
│ ├── designing-syntax/
│ ├── debugging-workflows/
│ └── using-templates/
├── agents/ # Permanent agents
├── temp-agents/ # Ephemeral (auto-cleaned)
├── temp-scripts/ # Generated scripts
├── examples/ # Templates (.flow)
└── docs/ # Documentation
# Headless (no checkpoints)
claude -p "Execute @examples/tdd-implementation.flow"
# With parameters
claude -p "/orchestration:run $(cat workflow.flow)" \
--output-format json
Workflow complete!
Temp agents: security-scanner, api-wrapper
Save as permanent?
[Save all] [Save security-scanner] [Delete all]
---
name: api-integration
parameters:
- API_URL: "https://api.example.com"
- NUM_ITEMS: 10
---
workflow: |
general-purpose:"Fetch {{NUM_ITEMS}} from {{API_URL}}":data ->
general-purpose:"Format results":output
Workflow hangs → Checkpoint requires user response or remove for headless
Temp script fails
→ Check temp-scripts/ for generated file
→ Verify API credentials and dependencies
Agent not found
→ Built-in: exact names (Explore, general-purpose)
→ Plugin: use orchestration: prefix
→ Temp: use $ prefix
MIT License | Built for Claude Code community
npx CLI installing 100+ agents, commands, hooks, and integrations in one command
干净、强大、属于你的 AI Agent 平台 --AI agents, without the clutter.
Native macOS app to monitor Claude AI usage limits and watch your coding sessions live
Pocket Flow: Codebase to Tutorial