Claude Team

Claude-team is an MCP server that lets you spawn and manage teams of Claude Code sessions via iTerm2. Each worker gets their own terminal pane, optional git worktree, and can be assigned beads issues.

Why Use Claude Team?

• Parallelism: Fan out work to multiple agents working simultaneously
• Context isolation: Each worker has fresh context, keeps coordinator context clean
• Visibility: Real Claude Code sessions you can watch, interrupt, or take over
• Git worktrees: Each worker can have an isolated branch for their work

⚠️ Important Rule

NEVER make code changes directly. Always spawn workers for code changes. This keeps your context clean and provides proper git workflow with worktrees.

Prerequisites

• macOS with iTerm2 (Python API enabled: Preferences → General → Magic → Enable Python API)
• claude-team MCP server configured in ~/.claude.json