create-claude-team-cmux

Scaffold a six-role Claude Code team into any repository. The generated setup can run on cmux or tmux, sends prompts to individual roles, captures role output, and optionally isolates agents in Git worktrees.

Quick Start

npx create-claude-team-cmux init --transport cmux
npx create-claude-team-cmux doctor --install
scripts/claude_team.sh start .

Use In A New Project

From the project you want to add the Claude team to:

mkdir my-project
cd my-project
git init
npx create-claude-team-cmux@latest init --transport cmux
npx create-claude-team-cmux@latest doctor --install
scripts/claude_team.sh start .

This also installs Claude Code slash commands under .claude/commands, so you can use /team_start, /team_panes, /team_to, /team_capture, and /team_env inside Claude Code.

Use --transport tmux instead of --transport cmux if you prefer tmux:

npx create-claude-team-cmux@latest init --transport tmux
scripts/claude_team.sh start . --transport tmux --attach

For tmux, --attach starts the team and connects to the session in one command. If the session already exists, it attaches to the existing session.

When the team starts, the script also makes the slash commands available in each role's working directory. This matters in worktree mode, where each role runs Claude from .claude/worktrees/<role> instead of the project root.

Inside Claude Code:

/team_start .
/team_panes
/team_to developer Implement only the approved API webhook change.
/team_capture qa

Commands

npx create-claude-team-cmux init
npx create-claude-team-cmux init --transport cmux
npx create-claude-team-cmux init --transport tmux
npx create-claude-team-cmux init --worktrees
npx create-claude-team-cmux install-commands
npx create-claude-team-cmux init-worktrees
npx create-claude-team-cmux doctor
npx create-claude-team-cmux doctor --install

If slash commands are missing from an existing project, reinstall them with:

npx create-claude-team-cmux@latest install-commands
# or from an already scaffolded project:
scripts/claude_team.sh install-commands

Generated Contract

Each Claude role receives:

• CLAUDE_TEAM_ROLE
• CLAUDE_PROJECT_DIR
• CLAUDE_SESSION_NAME
• CLAUDE_TEAM_TRANSPORT

The hooks then load:

• .team/current-goal.md
• .team/roles/<role>.md
• .team/file-ownership.json
• .team/role-presets.json

Collision Control

For serious parallel work, run:

npx create-claude-team-cmux init-worktrees

This creates one Git worktree per role under .claude/worktrees/<role>. Research and QA roles can stay read-only or work in isolated branches, while Lead performs final integration.

Install Logic

doctor --install can install missing local tools on macOS:

• tmux: brew install tmux
• cmux: brew tap manaflow-ai/cmux && brew install --cask cmux
• cmux CLI symlink: /Applications/cmux.app/Contents/Resources/bin/cmux to /usr/local/bin/cmux

The installer prints manual steps when Homebrew or macOS support is unavailable.