orchestra

Orchestra for Claude Code

Turn Claude Code into a semi-autonomous development team with specialized AI agents, automated quality gates, and seamless integrations.

English | 日本語

🔒 Security: Orchestra Plugin uses automated hooks with built-in safety guards. Dangerous operations are automatically blocked. See docs/SECURITY.md for details.

Why Orchestra?

Just use Claude Code as you normally would. No new commands to learn, no complex workflows. Orchestra Plugin works quietly in the background:

• 🤖 Multi-agent coordination - Main Claude Code handles PM, while specialized agents (Riley, Skye, Finn, Kai, Leo, Iris, Nova, Mina, Eden, Blake, Theo) collaborate automatically
• 📊 Real-time progress tracking - See which agents are working, on what, and how far along they are
• 🛡️ Automated quality gates - Pre-merge checks, security scans, test validation run automatically
• 🔌 Seamless integrations - GitHub, Vercel, Shopify, Slack - all connected and ready
• 🌐 Browser automation - Built-in Playwright integration for web testing and automation
• 🧠 Memory Bank integration - Persistent project knowledge that survives session restarts
• 🎯 Evidence-based - Changelogs, test plans, and documentation generated automatically

It just works. Install once, code naturally.

Quick Start

Installation

Orchestra Plugin requires MCP servers to be set up locally. Follow these steps:

1. Clone and Configure

git clone https://github.com/tstomtimes/orchestra.git
cd orchestra
cp .env.example .env
# Edit .env with your GitHub token (required) and optional service tokens

2. Run Setup Script

./setup.sh

This installs:

• Node.js dependencies (Express, Playwright, TypeScript)
• Playwright Chromium browser for automation
• Python virtual environment and packages (elevenlabs, requests)
• All MCP servers (Browser, GitHub, Vercel, Shopify, Slack, etc.)
• Memory Bank initialization (persistent project knowledge)
• Hooks and quality gates

Alternatively, you can run the setup from within Claude Code:

/orchestra-setup

3. Install Plugin in Claude Code

In Claude Code, run:

/plugin marketplace add /path/to/orchestra
/plugin install orchestra

Replace /path/to/orchestra with the full path to your cloned repository.

4. Restart Claude Code

Restart Claude Code to activate all features.

Using Orchestra in Other Projects

After installing the Orchestra Plugin, configure each project where you want to use it:

1. Copy and Configure Settings

Copy the .claude/settings.json file from the Orchestra repository:

# In your project directory
cd /path/to/your-project

# Create .claude directory if it doesn't exist
mkdir -p .claude

# Copy Orchestra settings
cp /path/to/orchestra/.claude/settings.json .claude/settings.json

2. Update Plugin Path

IMPORTANT: Edit .claude/settings.json and update the path to point to your Orchestra installation:

{
  "extraKnownMarketplaces": {
    "orchestra-marketplace": {
      "source": {
        "source": "directory",
        "path": "/absolute/path/to/orchestra"  ← Update this!
      }
    }
  }
}

Replace /absolute/path/to/orchestra with the full path where you cloned the Orchestra repository.

What this enables:

• ✅ Auto-approval for all safe tools (dangerous commands blocked by safety guard)
• ✅ Access to 12 specialized agents
• ✅ Automatic hook execution (agent routing, safety guards, quality gates)
• ✅ Slash commands (/browser, /screenshot, /orchestra-setup)

3. Restart Claude Code

Restart Claude Code to apply the configuration.

4. Ready to Use

All Orchestra features are now available in your project:

• ✅ 11 specialized agents (Riley, Skye, Finn, Eden, Kai, Leo, Iris, Nova, Mina, Theo, Blake) coordinated by main Claude Code
• ✅ Automatic agent routing
• ✅ Auto-approval with safety guard (only dangerous commands blocked)
• ✅ Slash commands (/browser, /screenshot, /orchestra-setup)

Important: The plugin's hooks, agents, and commands work automatically. No additional files needed in your project. Just copy .claude/settings.json and you're done.

Start Coding

Use Claude Code exactly as before. Orchestra Plugin enhances everything automatically:

You: "Add a user profile page with avatar upload"

→ Claude Code breaks down and coordinates the task
→ Mina (Frontend) handles UI implementation
→ Eden (QA) validates quality
→ Iris (Security) checks for vulnerabilities
→ Pre-merge hooks ensure everything passes
→ Changelog and docs generated automatically

Features That Work Automatically

Memory Bank Integration

Orchestra automatically initializes persistent project knowledge that survives Claude Code session restarts.

What is Memory Bank?