# 🎼 Code Conductor image **Orchestrate multiple AI coding agents. Ship 10x faster.** ## The Problem You're using Claude Code to ship features, but you're still working sequentially. One task at a time. One PR at a time. Meanwhile, your backlog keeps growing. ## The Solution Code Conductor lets you run multiple AI agents in parallelβ€”each working on different features simultaneously. No conflicts. No coordination overhead. Just pure, parallelized productivity. **Transform your workflow:** - πŸš€ **Hours, not weeks** - Multiple agents tackle your backlog in parallel - πŸ”’ **Zero merge conflicts** - Each agent works in isolated git worktrees - πŸ€– **Works with Claude Code** - Your favorite AI assistant, multiplied - 🎯 **Self-managing** - Agents claim tasks, implement, and ship autonomously ## Quick Start One command. 60 seconds. Done. ```bash bash <(curl -fsSL https://raw.githubusercontent.com/ryanmac/code-conductor/main/conductor-init.sh) ``` The installer auto-detects your stack (React, Python, Go, etc.) and configures everything. **No GitHub tokens needed. No complex setup.** ✨ **What you get:** - βœ… GitHub Actions workflows that use built-in authentication - βœ… No manual token creation or repository secrets required - βœ… AI code reviews work automatically on all PRs - βœ… Language-agnostic setup (no Python CI/CD added to non-Python projects) **For Claude Code (non-interactive):** ```bash curl -fsSL https://raw.githubusercontent.com/ryanmac/code-conductor/main/conductor-init.sh | bash -s -- --auto ``` **With automatic PR creation and auto-merge:** ```bash curl -fsSL https://raw.githubusercontent.com/ryanmac/code-conductor/main/conductor-init.sh | bash -s -- --auto --create-pr --auto-merge ``` **Or paste this prompt into Claude Code:** ``` I need to move faster. Install Code Conductor into this project so we can run multiple Claude Code agents at once. Execute: curl -fsSL https://raw.githubusercontent.com/ryanmac/code-conductor/main/conductor-init.sh | bash -s -- --auto --create-pr --auto-merge ``` ## Uninstalling Need to remove Code Conductor? We've got you covered with a safe, interactive uninstaller: ```bash python uninstall.py ``` **What it removes:** - βœ… `.conductor/` directory and all configuration - βœ… `conductor` wrapper script - βœ… GitHub workflows (only conductor-specific ones) - βœ… Git worktrees created by conductor - βœ… Conductor section from CLAUDE.md **What it preserves:** - βœ… Your own GitHub workflows - βœ… Your code and project files - βœ… GitHub issues and labels (manual cleanup if desired) **Options:** ```bash python uninstall.py --dry-run # See what would be removed python uninstall.py --force # Skip confirmation prompt python uninstall.py --verbose # Detailed output ``` ## See It In Action ```bash # Create a task (GitHub Issue) gh issue create --label "conductor:task" --title "Add dark mode toggle" # Launch an agent ./conductor start frontend # Watch it work # βœ“ Claims task #42 # βœ“ Creates isolated worktree # βœ“ Implements feature # βœ“ Opens pull request # βœ“ Moves to next task # Launch more agents to parallelize ./conductor start backend ./conductor start dev ``` **The secret:** Each agent works in its own git worktreeβ€”like having multiple copies of your repo. Agent A refactors authentication while Agent B adds dark mode. Zero conflicts. ## Learn More πŸ“š **[Full Documentation β†’](docs/)** - [Installation Guide](docs/INSTALLATION.md) - All setup options - [Stack Support](docs/STACK_SUPPORT.md) - Works with React, Vue, Python, Go, and more - [Architecture](docs/ARCHITECTURE.md) - How it all works under the hood - [AI Code Review](docs/AI_CODE_REVIEW.md) - Smart, opt-in PR reviews - [FAQ](docs/FAQ.md) - Common questions about tokens, Python, and workflows - [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions πŸš€ **[Power User Prompts](CLAUDE_CODE_PROMPT.md)** - Game-changing automation with Claude Code ## Community - πŸ› **Found a bug?** [Report it](https://github.com/ryanmac/code-conductor/issues) - πŸ’‘ **Have an idea?** [Start a discussion](https://github.com/ryanmac/code-conductor/discussions) - πŸ› οΈ **Want to contribute?** [See our guide](.github/CONTRIBUTING.md) - 𝕏 **Share your success** Mention [@ryanmac](https://x.com/ryanmac) with #CodeConductor --- **Stop juggling tasks. Start shipping features.** 🎼