ccmultihelper

> 🚀 Single-session parallel worktree automation with MCP server orchestration

• 🎯 Single-Session Architecture: One Claude Code session manages everything
• 🤖 Background Agent System: Parallel work via tmux-based agents
• 🔧 Modern MCP Server: TypeScript SDK with Zod validation
• 🎨 Natural Language Interface: Intuitive MCP tool commands
• 📦 Self-Contained Setup: Zero dependencies beyond Node.js and tmux

• Node.js 18+, Git repository, tmux, Claude Code

Option 1: One-Command (Recommended)

cd /path/to/your/project
bunx ccmultihelper init
claude

Option 2: Install Globally

npm install -g ccmultihelper
cd /path/to/your/project
ccmultihelper init
claude

Option 3: MCP Server Only

# Register as MCP server (no installation needed)
claude mcp add worktree-orchestrator --scope project npx -y ccmultihelper

Use natural language in Claude Code:

• "Create a feature worktree called user-auth"
• "Spawn an agent in feature worktree to implement login"
• "Show me the status of all worktrees"
• "Kill the agent that's stuck"

• worktree-create - Create/manage worktrees
• worktree-spawn-agent - Launch background agents
• worktree-status - View comprehensive status
• worktree-agent-status - Monitor agent lifecycle
• worktree-agent-logs - Stream real-time output
• worktree-agent-progress - Track file changes
• worktree-kill-agent - Terminate agents
• worktree-integrate - Merge branch changes

bunx ccmultihelper init           # Initialize modern setup
ccmultihelper init                # Same (if installed globally)

bunx ccmultihelper init --legacy  # Legacy multi-session setup
ccmultihelper