A dev agent multiplexer for git worktrees and claude code (or other agents). standardagents/dmux is a development multiplexer designed to manage multiple AI coding agents concurrently within isolated git worktrees. It targets engineers and power users seeking to streamline parallel development workflows, enabling agents to work independently without conflicts and facilitating seamless merging of their contributions.

How It Works

The core of dmux leverages tmux panes, with each pane representing an isolated development environment. It automatically creates a dedicated git worktree and branch for every agent task, ensuring complete separation. This approach prevents inter-agent conflicts and allows for side-by-side development. Upon task completion, a simple command triggers an automated commit, merge, and cleanup process back to the main branch.

Quick Start & Requirements

Installation is straightforward via npm: npm install -g dmux. To initiate, navigate to your project directory and run dmux. Prerequisites include tmux (v3.0+), Node.js (v18+), and Git (v2.20+). The system requires at least one supported AI agent: Claude Code, Codex, or OpenCode. An OpenRouter API key is optional but recommended for AI-driven branch naming and commit messages. Full documentation is available at dmux.ai.

Highlighted Details

• Worktree Isolation: Each tmux pane operates with a distinct, full working copy of the repository, eliminating conflicts between agents.
• Agent Agnosticism: Supports integration with Claude Code, Codex, and OpenCode, with potential for expansion.
• Parallel Development: Facilitates A/B testing by running multiple agents on the same prompt simultaneously.
• Automated Workflow: Features AI-powered branch and commit message generation (optional), alongside a smart merging process that handles commits, merges, and cleanup in one step.
• Extensibility: Includes support for multi-project sessions and lifecycle hooks for custom scripting during worktree events.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap were provided in the README snippet.

Licensing & Compatibility

The project is released under the MIT license, which is highly permissive and generally suitable for commercial use, including integration into closed-source projects.

Limitations & Caveats

The tool's functionality is dependent on the correct setup and availability of tmux, Node.js, Git, and at least one compatible AI agent. Advanced features like AI-generated metadata require an external API key. The effectiveness of the "smart merging" may depend on the complexity of the code changes produced by the agents.