Repolode
standardagents

standardagents/dmux

A terminal multiplexer that runs multiple AI coding agents in parallel, each in its own tmux pane with a separate git worktree and branch.

Stars
1,816
Forks
138
Open issues
39
Last commit
3 months ago

What is it?

dmux is a CLI that manages several AI coding agents at once. Each task gets its own tmux pane backed by a separate git worktree and branch, so agents working on different features cannot step on each other's files. When a task finishes, you can merge its branch back into the main branch or push it and open a GitHub pull request from the pane menu.

The tool supports a wide range of agent CLIs, including Claude Code, Codex, OpenCode, Gemini CLI, Cursor CLI and Copilot CLI, and you can launch any combination of them per prompt. Regular terminal panes restore to their last directory, and supported agent sessions are tracked so the conversation resumes when a pane is recreated.

Other features include AI-generated branch names and commit messages, a built-in file browser for inspecting a pane's worktree and diffs, lifecycle hooks around worktree creation and merges, and optional macOS notifications when a background agent needs attention. It requires tmux 3.0+, Node.js 18+ and Git 2.20+.

Key features

  • 01Creates an isolated git worktree and branch for each agent pane.
  • 02Supports Claude Code, Codex, Gemini CLI, Cursor CLI, Copilot CLI and several other agent CLIs.
  • 03Merges a pane's branch into main or opens a GitHub pull request from the pane menu.
  • 04Resumes tracked agent conversations when a pane is recreated.
  • 05Includes a built-in file browser for worktree files and diffs.
  • 06Runs lifecycle hooks on worktree create and merge events.

Use cases

  • Running several coding agents on different features of the same repository at once.
  • Letting an agent attempt a task on its own branch and merging only if the result is good.
  • Comparing how different agent CLIs handle the same prompt in separate worktrees.
  • Managing parallel work across multiple repositories in one tmux session.

Quick start

  1. 1

    Install dmux globally with npm

    npm install -g dmux
  2. 2

    Change into your project directory

    cd /path/to/your/project
  3. 3

    Start dmux

    dmux
  4. 4

    Press n to create a new pane, type a prompt, and pick an agent

Things to know

  • Requires tmux 3.0+, Node.js 18+ and Git 2.20+ installed.
  • Needs at least one supported agent CLI, and some AI features need an inference provider API key or a paid subscription login.
  • macOS notifications are macOS-only.

In collections

Topics

FAQ

What is dmux?
A terminal multiplexer that runs multiple AI coding agents in parallel, each in its own tmux pane with a separate git worktree and branch. dmux is a CLI that manages several AI coding agents at once. Each task gets its own tmux pane backed by a separate git worktree and branch, so agents working on different features cannot step on each other's files. When a task finishes, you can merge its branch back into the main branch or push it and open a GitHub pull request from the pane menu.
Is dmux free to use? What license does it have?
dmux is open source under the MIT license. Check the license terms before using it in commercial products.
Is dmux still maintained?
Updated within 6 months. The last commit to dmux was on Aug 16, 2026.
What can I use dmux for?
Running several coding agents on different features of the same repository at once. Letting an agent attempt a task on its own branch and merging only if the result is good. Comparing how different agent CLIs handle the same prompt in separate worktrees. Managing parallel work across multiple repositories in one tmux session.
How do I install dmux?
Install dmux globally with npm: npm install -g dmux Change into your project directory: cd /path/to/your/project Start dmux: dmux Press n to create a new pane, type a prompt, and pick an agent
Where can I get dmux?
The source code and installation instructions are on GitHub: https://github.com/standardagents/dmux

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects