# dmux

> Manage multiple AI coding agents in isolated git worktrees using tmux for parallel development, branching, and merging.

dmux is a command-line tool for running multiple AI coding agents in parallel using tmux and git worktrees. It enables developers to manage Claude Code, Codex, or OpenCode agents simultaneously, each working in isolated git worktrees with their own branches. This allows for parallel development workflows where multiple agents can tackle different tasks without conflicts, and changes can be merged back to the main branch when complete.

- **Parallel Agent Management** allows running multiple AI coding agents simultaneously in separate tmux panes, each with its own isolated git worktree and branch for conflict-free parallel development.

- **Git Worktree Integration** creates independent working copies of your repository for each agent, sharing the same .git directory for space efficiency while maintaining complete isolation between tasks.

- **Two-Phase Merge Flow** performs safe merging by first merging main into the worktree to resolve conflicts in isolation, then merging the worktree back to main with automatic cleanup of branches and worktrees.

- **AI-Powered Commit Messages** uses OpenRouter to generate smart branch names from prompts and conventional commit messages from git diffs when merging changes.

- **Lifecycle Hooks** provides 11 customizable hooks including worktree_created, pre_merge, post_merge, and more, allowing automation of dependency installation, testing, and notifications.

- **Multi-Agent A/B Testing** enables running two different agents on the same task side-by-side to compare approaches and merge the best result.

- **Multi-Project Support** allows attaching multiple git repositories to a single tmux session for managing panes across different projects simultaneously.

- **Pane Status Detection** monitors each agent pane to determine if the agent is working, waiting for input, or idle using LLM analysis of terminal output.

- **TUI and Keyboard Navigation** provides a keyboard-first interface with shortcuts for creating panes, jumping between them, merging, and managing the entire workflow.

To get started, install dmux globally with `npm -g i dmux`, navigate to a git repository, and run `dmux`. Press `n` to create a new pane, enter a description of the task, select an agent, and watch it work. When done, press `m` to merge changes back to your main branch.

## Features
- Parallel AI agent management with tmux
- Git worktree isolation for each agent
- Two-phase merge workflow
- AI-powered commit message generation
- Smart branch naming from prompts
- 11 lifecycle hooks for automation
- Multi-agent A/B testing
- Multi-project session support
- Pane status detection
- Keyboard-first TUI navigation
- Auto-commit uncommitted changes
- Merge conflict detection and AI resolution
- Autopilot mode for autonomous operation
- HTTP callback API for hooks
- Configurable global and project settings

## Integrations
Claude Code, OpenCode, Codex, tmux, Git, OpenRouter

## Platforms
MACOS, LINUX, WEB, API

## Pricing
Open Source

## Links
- Website: https://dmux.ai
- Documentation: https://dmux.ai
- Repository: https://github.com/formkit/dmux
- EveryDev.ai: https://www.everydev.ai/tools/dmux