Orchestra Plugin Setup

Run the complete setup script to install all MCP servers, dependencies, and configure the Orchestra Plugin environment.

Task

Execute the Orchestra setup script to install:

• Node.js dependencies (Express, Playwright, TypeScript)
• Playwright Chromium browser
• Python virtual environment and packages (elevenlabs, requests)
• Configure hooks and permissions (.claude/settings.json with auto-approve)
• Install safety guard hook (blocks dangerous operations only)
• Create necessary directories (artifacts, etc.)

Steps

1. Check if setup.sh exists and is executable:

   if [ ! -f "./setup.sh" ]; then
     echo "❌ setup.sh not found. Please ensure you're in the Orchestra repository root."
     exit 1
   fi
   

2. Make setup.sh executable if needed:

   chmod +x ./setup.sh
   

3. Run the setup script:

   ./setup.sh
   

4. After completion, show next steps:

   ✅ Orchestra Plugin setup completed!
   
   Next steps:
   1. Edit .env file to add your API keys (if not done already)
   2. Restart Claude Code to activate all features
   3. Start coding - Orchestra will automatically enhance your workflow!
   
   Available features:
   - /browser - Start Browser MCP server
   - /screenshot - Capture web screenshots
   - 11 specialized AI agents (Riley, Skye, Finn, Eden, Kai, Leo, Iris, Nova, Mina, Theo, Blake) coordinated by main Claude Code
   - Automated quality gates (before_task, before_pr, before_merge, before_deploy, after_deploy)
   - Multi-agent orchestration with parallel execution
   

Notes

• This command should be run once after cloning the Orchestra repository
• The setup script checks for prerequisites (Node.js 18+, Python 3.8+)
• All hooks automatically skip if tools aren't installed (no errors)
• Environment variables can be configured later in the .env file
• Only GITHUB_TOKEN is required; all other tokens are optional
• The script creates symlinks for hooks and slash commands
• Browser server can be started separately with /browser command

Auto-Approval & Safety

The setup creates .claude/settings.json with:

• "permissions.allow": ["*"] - Auto-approve all tools (no confirmation dialogs)
• Safety guard hook (hooks/user-prompt-submit.sh) blocks dangerous operations:
  • rm -rf /, system file modifications
  • sudo shutdown/reboot
  • git push --force
  • Database drops (DROP DATABASE/TABLE)
  • And more...

This enables autonomous operation while preventing destructive actions.