Manage multiple AI coding agents in isolated git worktrees.
Branch, develop, and merge — all in parallel.
Documentation · Getting Started · Issues
npm install -g dmuxcd /path/to/your/project
dmuxPress n to create a new pane, type a prompt, pick one or more agents (or none for a plain terminal), and dmux handles the rest — worktree, branch, and agent launch.
dmux creates a tmux pane for each task. Every pane gets its own git worktree and branch so agents work in complete isolation. When a task is done, open the pane menu with m and choose Merge to bring it back into your main branch.
- Worktree isolation — each pane is a full working copy, no conflicts between agents
- Agent support — Claude Code, Codex, OpenCode, Cline CLI, Gemini CLI, Qwen CLI, Amp CLI, pi CLI, Cursor CLI, Copilot CLI, and Crush CLI
- Multi-select launches — choose any combination of enabled agents per prompt
- AI naming — branches and commit messages generated automatically
- Smart merging — auto-commit, merge, and clean up in one step
- macOS notifications — background panes can send native attention alerts when they settle and need you
- Built-in file browser — inspect a pane's worktree, search files, and preview code or diffs without leaving dmux
- Pane visibility controls — hide individual panes, isolate one project, or restore everything later without stopping work
- Multi-project — add multiple repos to the same session
- Lifecycle hooks — run scripts on worktree create, pre-merge, post-merge, and more
| Key | Action |
|---|---|
n |
New pane (worktree + agent) |
t |
New terminal pane |
j / Enter |
Jump to pane |
m |
Open pane menu |
f |
Browse files in selected pane's worktree |
x |
Close pane |
h |
Hide/show selected pane |
H |
Hide/show all other panes |
p |
New pane in another project |
P |
Show only the selected project's panes, then show all |
s |
Settings |
q |
Quit |
- tmux 3.0+
- Node.js 18+
- Git 2.20+
- At least one supported agent CLI (for example Claude Code, Codex, OpenCode, Cline CLI, Gemini CLI, Qwen CLI, Amp CLI, pi CLI, Cursor CLI, Copilot CLI, Crush CLI)
- OpenRouter API key (optional, for AI branch names and commit messages)
Full documentation is available at dmux.ai, including setup guides, configuration, and hooks.
See CONTRIBUTING.md for the recommended local "dmux-on-dmux" development loop, hook setup, and PR workflow.
MIT