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, press m to merge 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
- 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 |
Merge pane to main |
x |
Close pane |
p |
New pane in another project |
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