Cmux

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](https://git-scm.com/docs/git-worktree) 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        # creates worktree + branch, runs setup hook, opens Claude

That's it. One command, one agent, fully isolated. See [Workflow](#workflow) for the full loop.

Commands

Command	What it does
cmux new [--from ]	Create new worktree + branch, run setup hook, launch Claude
cmux start	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
cmux merge [branch] [--squash]	Merge worktree branch into your primary checkout (no args = current worktree)
cmux rm [branch | --all]	Remove a worktree and its branch (no args = current, --all = every worktree with confirmation)
cmux init [--replace]	Generate .cmux/setup hook using Claude (--replace to regenerate)
cmux update	Update cmux to the latest version
cmux version	S