🎭 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.

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...            ║
╚════════════════════════════════════╝

Syntax Reference

| Syntax | Meaning | Example | |--------|---------|---------| | -> | Sequential | step1 -> step2 | | || | Parallel | [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" |

Built-in Agents

Explore - Fast codebase exploration and search
Plan - Planning and breaking down tasks
general-purpose - Versatile agent for complex multi-step tasks

---

Examples

Reddit Startup Analyzer

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"

TDD Implementation

# 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"

Bug Investigation

# 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"

Project Structure

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

Advanced

Standalone Execution

# Headless (no checkpoints)
claude -p "Execute @examples/tdd-implementation.flow"
With parameters
claude -p "/orchestration:run $(cat workflow.flow)" \
  --output-format json

Agent Promotion

Workflow complete!
Temp agents: security-scanner, api-wrapperSave as permanent?
[Save all] [Save security-scanner] [Delete all]

Template Parameters

---
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

Troubleshooting

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

Star History

Support

---

MIT License | Built for Claude Code community

--- Tranlated By Open Ai Tx | Last indexed: 2026-03-04 ---