Dmux

<p align="center"> <img src="./dmux.png" alt="dmux logo" width="400" /> </p> <h3 align="center">Parallel agents with tmux and worktrees</h3> <p align="center"> Manage multiple AI coding agents in isolated git worktrees.<br/> Branch, develop, and merge &mdash; all in parallel. </p> <p align="center"> <a href="https://dmux.ai"><strong>Documentation</strong></a> &nbsp;&middot;&nbsp; <a href="https://dmux.ai#getting-started"><strong>Getting Started</strong></a> &nbsp;&middot;&nbsp; <a href="https://github.com/formkit/dmux/issues"><strong>Issues</strong></a> </p>

---

<img src="./dmux.webp" alt="dmux demo" width="100%" />

Install

npm install -g dmux

Quick Start

cd /path/to/your/project
dmux

Press 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.

What it does

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

Keyboard Shortcuts

| 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 |

Requirements

• 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)

Documentation

Full documentation is available at dmux.ai, including setup guides, configuration, and hooks.

Contributing

See CONTRIBUTING.md for the recommended local "dmux-on-dmux" development loop, hook setup, and PR workflow.

License

MIT