dmux - AI-Powered Development Agent Multiplexer

dmux simplifies the process of running multiple development agents concurrently. Designed to enhance productivity, it enables effortless management of separate coding tasks using tmux and git worktrees integrated with Claude Code.

Key Features

• Parallel Development: Seamlessly work on multiple features at once in dedicated tmux panes.
• Git Worktree Integration: Each pane operates in its own isolated git worktree, ensuring a clean and organized development environment.
• AI-Powered Functionality: Automatically generates branch names and commit messages to streamline the workflow.
• Claude Code Integration: Effortlessly launch and interact with Claude Code, accepting edits directly within the development environment.
• Project Isolation: Each project is assigned its own tmux session, providing a dedicated workspace.
• Smart Merging: Easily merge changes into the main branch with a single command, along with automatic cleanup of resources.

Quick Usage Guide

• Start dmux: Begin by navigating to your project directory and executing dmux.
• Create a New Development Pane: Press n or select the option to open a new pane. Enter a prompt when prompted (optional).
• Navigating Between Panes: Use the up/down arrow keys to switch between open panes. Press j or Enter to focus on a selected pane.
• Merging Work: Select the desired pane and press m to merge the branch into the main project.

Example Command Sequence

# Start dmux in your project folder
cd /path/to/your/project
dmux

# Create a new feature pane
# Press 'n' and enter: "add user dashboard"

# Create another pane for a bug fix
# Press 'n' and enter: "fix memory leak"

# Switch between work
# Press 'j' to navigate to any pane and continue working

# Merge when done
# Select the pane and press 'm'

Session and Branch Management

dmux automatically creates new git worktrees in sibling directories with AI-generated branch naming tailored to individual tasks. Integration with Claude facilitates immediate code generation and acceptance, further amplifying development efficiency.

tmux Configuration Tips

For optimal use, a basic tmux configuration can enhance the overall experience:

# Custom tmux settings for better visuals and navigation
defaults
set -g mouse on
set -g window-style 'fg=colour247,bg=colour236'
set -g window-active-style 'fg=default,bg=colour234'
# Customize pane borders and key bindings

This configuration enhances navigation and provides visual feedback to distinguish active panes, supporting a streamlined development experience.

Prerequisites

Ensure the following dependencies are installed:

• tmux version 3.0 or higher
• Node.js version 18 or higher
• Git version 2.20 or higher (with worktree support)
• Claude Code CLI must be installed and accessible
• OpenRouter API Key (recommended for AI features)

dmux stands out as an efficient tool for developers looking to enhance their workflow when managing multiple coding tasks. Its innovative features minimize setup time and maximize productivity, allowing faster iterations and more efficient project management.