Parallel agents with tmux and worktrees

Manage multiple AI coding agents in isolated git worktrees.
Branch, develop, and merge — all in parallel.

Documentation  ·  Getting Started  ·  Issues

---

Install

npm install -g dmux

Quick Start

cd /path/to/your/project
dmux

Press n to create a new pane, type a prompt, pick an agent, 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, 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, and OpenCode
• A/B launches — run two agents on the same prompt side-by-side
• 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

Keyboard Shortcuts

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

Requirements

• tmux 3.0+
• Node.js 18+
• Git 2.20+
• At least one agent: Claude Code, Codex, or OpenCode
• OpenRouter API key (optional, for AI branch names and commit messages)

Documentation

Full documentation is available at dmux.ai, including setup guides, configuration, hooks, and the HTTP API reference.

License

MIT