dmux

dmux logo

<h3 align="center">Parallel agents with tmux and worktrees</h3>

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

Specs

README