dmux-workflows

Orchestrates parallel AI agent sessions across tmux panes using dmux.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/freedom909/real-estate-saas --skill dmux-workflows-freedom909
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dmux-workflows
Source: https://github.com/freedom909/real-estate-saas/tree/main/.trae/skills/dmux-workflows
Command: npx skills add https://github.com/freedom909/real-estate-saas --skill dmux-workflows-freedom909

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple AI coding agents on large tasks is slow and error-prone when done sequentially in a single session. This Skill provides patterns for running parallel agent sessions in tmux panes, so independent workstreams like research, implementation, testing, and review can proceed simultaneously. ## Core Features & Use Cases - Parallel Agent Orchestration: Launch and manage multiple agent panes (Claude Code, Codex, OpenCode, Gemini, and more) with dmux's create-and-merge workflow. - Five Workflow Patterns: Ready-made patterns for research-plus-implementation, multi-file features, test-and-fix loops, cross-harness delegation, and parallel code review pipelines. - Git Worktree Isolation: Guidance for isolating file changes per agent using git worktrees, plus an ECC helper script that automates branch-backed worktrees, per-worker task files, and tmux pane launching. - Use Case: Split a billing feature into three panes—one for database migrations, one for API endpoints, one for UI components—then merge the results and integrate in the main pane. ## Quick Start Ask the agent to split the current task into parallel dmux panes, for example by saying "use dmux to run the auth implementation and the test writing in parallel panes and merge the results."

Frequently Asked Questions about dmux-workflows

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multiple AI coding agents in parallel?▼

Use dmux, a tmux-based pane manager for AI agents. Start a dmux session, press 'n' to create a new pane with a prompt for each agent, and press 'm' to merge a pane's output back into the main session when it finishes.

What tasks should I parallelize across agent panes?▼

Parallelize only independent tasks with clear boundaries, such as separate files or concerns. Good examples are research versus implementation, schema versus API versus UI work, and parallel security, performance, and test-coverage reviews.

Which AI agent harnesses does dmux support?▼

dmux supports Claude Code, Codex, OpenCode, Cline, Gemini, and Qwen. Each pane runs its own full agent session, so you can mix different harnesses for different subtasks in the same workflow.

How do I avoid merge conflicts with parallel agents?▼

Use git worktrees to give each agent pane an isolated branch and working directory. Create worktrees with 'git worktree add -b <branch> <path> HEAD', run each agent in its own worktree, then merge the branches when the work is done.

Why is my dmux pane not responding?▼

Switch to the pane directly or inspect it with 'tmux capture-pane -pt <session>:0.<pane-index>' to see its current output. If tmux itself is missing, install it with 'brew install tmux' on macOS or 'apt install tmux' on Linux.

What are the limitations of parallel agent workflows?▼

Each pane is a full agent session consuming API tokens, so keep total panes under five or six. Tasks that depend on each other's output should not be parallelized, and pane output should be reviewed before merging to avoid conflicts.