# dmux — Git Worktree Multiplexer for Coding Agents

> dmux multiplexes coding agents with tmux + isolated git worktrees, so parallel tasks never collide. Verified 1,552★; setup ~5–10 minutes.

## Install

Copy the content below into your project:

## Quick Use

```bash
npm install -g dmux
cd /path/to/your/project
dmux
# Press `n` to open a new pane (worktree + agent) and run tasks in parallel.
```

## Intro

dmux multiplexes coding agents with tmux + isolated git worktrees, so parallel tasks never collide. Verified 1,552★; setup ~5–10 minutes.

**Best for:** Solo devs or teams running multiple coding agents in parallel on the same repo

**Works with:** tmux, Git worktrees, Node.js 18+, many agent CLIs (Claude Code/Codex/Gemini/Cursor)

**Setup time:** 5-10 minutes

### Key facts (verified)

- GitHub: 1552 stars · 118 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `npm install -g dmux && dmux`.

## Main

- Use worktree isolation to prevent agent conflicts: each pane is a full working copy with its own branch as described in README.

- Adopt the built-in merge/PR flow: finish a task, then merge back or open a PR from the pane menu (README documents shortcuts).

- Keep it lightweight: start with plain terminal panes, then progressively enable agent CLIs once your team’s auth and policies are set.

### Source-backed notes

- README says each pane gets its own git worktree + branch so multiple agents can run in parallel safely.
- README lists supported agents including Claude Code, Codex, OpenCode, Cline CLI, Gemini CLI, Cursor CLI, and Copilot CLI.
- README documents install via `npm install -g dmux` and a quick start with `dmux` inside a repo.

### FAQ

- **Do I need an agent CLI to use dmux?**: No — README says you can create plain terminal panes; agents are optional.
- **What are the minimum requirements?**: README lists tmux 3.0+, Git 2.20+, and Node.js 18+.
- **How does it avoid merge conflicts?**: By isolating work per pane into separate worktrees/branches, as described in README.

## Source & Thanks

> Source: https://github.com/standardagents/dmux
> License: MIT
> GitHub stars: 1552 · forks: 118

---

<!-- ZH -->

## Quick Use

```bash
npm install -g dmux
cd /path/to/your/project
dmux
# Press `n` to open a new pane (worktree + agent) and run tasks in parallel.
```

## Intro

dmux 用 tmux + git worktree 隔离多路编码 agent，让并行任务互不干扰，并支持 Claude Code/Codex/Cursor 等 CLI。已验证 1,552★；约 5–10 分钟可上手。

**Best for:** 需要在同一仓库并行跑多个编码 agent 的个人或团队

**Works with:** tmux、Git worktree、Node.js 18+，以及多种 agent CLI（Claude Code/Codex/Gemini/Cursor）

**Setup time:** 5-10 minutes

### Key facts (verified)

- GitHub：1552 stars · 118 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`npm install -g dmux && dmux`。

## Main

- 用 worktree 隔离解决冲突：README 描述每个 pane 都是独立工作副本 + 分支，agent 互不踩踏。

- 利用内置的 merge/PR 流程：任务完成后在 pane 菜单里合并回主分支或创建 PR（README 有快捷键）。

- 先轻量再增强：可以先开纯终端 pane，确认权限/鉴权策略后再逐步开启各类 agent CLI。

### Source-backed notes

- README 表示每个 pane 都有独立 git worktree + 分支，从而安全并行运行多个 agent。
- README 列出支持的 agent：Claude Code、Codex、OpenCode、Cline CLI、Gemini CLI、Cursor CLI、Copilot CLI 等。
- README 给出安装 `npm install -g dmux` 与在仓库内直接运行 `dmux` 的 quick start。

### FAQ

- **不用 agent CLI 也能用吗？**：能。README 说明可以创建纯终端 pane，agent 是可选项。
- **最低要求是什么？**：README 列出 tmux 3.0+、Git 2.20+、Node.js 18+。
- **它如何减少冲突？**：通过每个 pane 独立 worktree/分支实现隔离（README 有说明）。

## Source & Thanks

> Source: https://github.com/standardagents/dmux
> License: MIT
> GitHub stars: 1552 · forks: 118


---
Source: https://tokrepo.com/en/workflows/dmux-git-worktree-multiplexer-for-coding-agents
Author: Script Depot