cmux — tmux for Claude Code

Run a fleet of Claude agents on the same repo — each in its own worktree, zero conflicts, one command each.

Claude Code works best when it has full ownership of the working directory. Want two agents working in parallel? They'll stomp on each other — conflicting edits, dirty state, broken builds. You need separate checkouts.

Git worktrees are the perfect primitive for this. They share the same .git database but give each agent its own directory tree — no cloning, no syncing, branches stay in lockstep. cmux wraps the entire worktree lifecycle into single commands so you can spin agents up, jump between them, and tear them down without thinking about it.

You wanna go fast without losing your goddamn mind. This is how.

Install

curl -fsSL https://github.com/craigsc/cmux/releases/latest/download/install.sh | sh

Then add .worktrees/ to your .gitignore:

echo '.worktrees/' >> .gitignore

Quick start

cmux new <your feature name>       # creates worktree + branch, runs setup hook, opens Claude

That's it. One command, one agent, fully isolated. See Workflow for the full loop.

Commands

| Command | What it does | |---------|-------------| | cmux new <branch> | Create new worktree + branch, run setup hook, launch Claude | | cmux start <branch> | Continue where you left off in an existing worktree | | cmux cd [branch] | cd into a worktree (no args = repo root) | | cmux ls | List active worktrees | | | Merge worktree branch into your primary checkout (no args = current worktree) | | | Remove a worktree and its branch (no args = current, = every worktree with confirmation) | | | Generate hook using Claude ( to regenerate) | | | Update cmux to the latest version | | | Show current version |