dmux

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.