---
id: daily-dmux-workflows
name: "dmux-workflows"
url: https://skills.yangsir.net/skill/daily-dmux-workflows
author: affaan-m
domain: ai-agent-orchestration-collaboration
tags: ["multi-agent-systems", "orchestration", "parallel-execution", "workflow-automation", "ai-agents"]
install_count: 3500
rating: 4.40 (47 reviews)
github: https://github.com/affaan-m/everything-claude-code
---

# dmux-workflows

> 使用dmux编排并行AI代理会话，协调多个Claude Code和Codex实例协同工作

**Stats**: 3,500 installs · 4.4/5 (47 reviews)

## Before / After 对比

### 多代理协作

**Before**:

手动切换不同AI助手窗口，复制粘贴上下文，任务分配混乱，协作效率低下

**After**:

自动编排并行会话，任务智能分配，结果自动汇总，复杂任务快速拆解完成

| Metric | Before | After | Change |
|---|---|---|---|
| 任务完成时间 | 120min | 30min | -75% |

## Readme

# dmux-workflows

# dmux Workflows

Orchestrate parallel AI agent sessions using dmux, a tmux pane manager for agent harnesses.

## When to Activate

- Running multiple agent sessions in parallel

- Coordinating work across Claude Code, Codex, and other harnesses

- Complex tasks that benefit from divide-and-conquer parallelism

- User says "run in parallel", "split this work", "use dmux", or "multi-agent"

## What is dmux

dmux is a tmux-based orchestration tool that manages AI agent panes:

- Press `n` to create a new pane with a prompt

- Press `m` to merge pane output back to the main session

- Supports: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen

**Install:** `npm install -g dmux` or see [github.com/standardagents/dmux](https://github.com/standardagents/dmux)

## Quick Start

```
# Start dmux session
dmux

# Create agent panes (press 'n' in dmux, then type prompt)
# Pane 1: "Implement the auth middleware in src/auth/"
# Pane 2: "Write tests for the user service"
# Pane 3: "Update API documentation"

# Each pane runs its own agent session
# Press 'm' to merge results back

```

## Workflow Patterns

### Pattern 1: Research + Implement

Split research and implementation into parallel tracks:

```
Pane 1 (Research): "Research best practices for rate limiting in Node.js.
  Check current libraries, compare approaches, and write findings to
  /tmp/rate-limit-research.md"

Pane 2 (Implement): "Implement rate limiting middleware for our Express API.
  Start with a basic token bucket, we'll refine after research completes."

# After Pane 1 completes, merge findings into Pane 2's context

```

### Pattern 2: Multi-File Feature

Parallelize work across independent files:

```
Pane 1: "Create the database schema and migrations for the billing feature"
Pane 2: "Build the billing API endpoints in src/api/billing/"
Pane 3: "Create the billing dashboard UI components"

# Merge all, then do integration in main pane

```

### Pattern 3: Test + Fix Loop

Run tests in one pane, fix in another:

```
Pane 1 (Watcher): "Run the test suite in watch mode. When tests fail,
  summarize the failures."

Pane 2 (Fixer): "Fix failing tests based on the error output from pane 1"

```

### Pattern 4: Cross-Harness

Use different AI tools for different tasks:

```
Pane 1 (Claude Code): "Review the security of the auth module"
Pane 2 (Codex): "Refactor the utility functions for performance"
Pane 3 (Claude Code): "Write E2E tests for the checkout flow"

```

### Pattern 5: Code Review Pipeline

Parallel review perspectives:

```
Pane 1: "Review src/api/ for security vulnerabilities"
Pane 2: "Review src/api/ for performance issues"
Pane 3: "Review src/api/ for test coverage gaps"

# Merge all reviews into a single report

```

## Best Practices

- **Independent tasks only.** Don't parallelize tasks that depend on each other's output.

- **Clear boundaries.** Each pane should work on distinct files or concerns.

- **Merge strategically.** Review pane output before merging to avoid conflicts.

- **Use git worktrees.** For file-conflict-prone work, use separate worktrees per pane.

- **Resource awareness.** Each pane uses API tokens — keep total panes under 5-6.

## Git Worktree Integration

For tasks that touch overlapping files:

```
# Create worktrees for isolation
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD

# Run agents in separate worktrees
# Pane 1: cd ../feature-auth && claude
# Pane 2: cd ../feature-billing && claude

# Merge branches when done
git merge feat/auth
git merge feat/billing

```

## Complementary Tools

Tool
What It Does
When to Use

**dmux**
tmux pane management for agents
Parallel agent sessions

**Superset**
Terminal IDE for 10+ parallel agents
Large-scale orchestration

**Claude Code Task tool**
In-process subagent spawning
Programmatic parallelism within a session

**Codex multi-agent**
Built-in agent roles
Codex-specific parallel work

## ECC Helper

ECC now includes a helper for external tmux-pane orchestration with separate git worktrees:

```
node scripts/orchestrate-worktrees.js plan.json --execute

```

Example `plan.json`:

```
{
  "sessionName": "skill-audit",
  "baseRef": "HEAD",
  "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
  "workers": [
    { "name": "docs-a", "task": "Fix skills 1-4 and write handoff notes." },
    { "name": "docs-b", "task": "Fix skills 5-8 and write handoff notes." }
  ]
}

```

The helper:

- Creates one branch-backed git worktree per worker

- Optionally overlays selected `seedPaths` from the main checkout into each worker worktree

- Writes per-worker `task.md`, `handoff.md`, and `status.md` files under `.orchestration/<session>/`

- Starts a tmux session with one pane per worker

- Launches each worker command in its own pane

- Leaves the main pane free for the orchestrator

Use `seedPaths` when workers need access to dirty or untracked local files that are not yet part of `HEAD`, such as local orchestration scripts, draft plans, or docs:

```
{
  "sessionName": "workflow-e2e",
  "seedPaths": [
    "scripts/orchestrate-worktrees.js",
    "scripts/lib/tmux-worktree-orchestrator.js",
    ".claude/plan/workflow-e2e-test.json"
  ],
  "launcherCommand": "bash {repo_root}/scripts/orchestrate-codex-worker.sh {task_file} {handoff_file} {status_file}",
  "workers": [
    { "name": "seed-check", "task": "Verify seeded files are present before starting work." }
  ]
}

```

## Troubleshooting

- **Pane not responding:** Switch to the pane directly or inspect it with `tmux capture-pane -pt <session>:0.<pane-index>`.

- **Merge conflicts:** Use git worktrees to isolate file changes per pane.

- **High token usage:** Reduce number of parallel panes. Each pane is a full agent session.

- **tmux not found:** Install with `brew install tmux` (macOS) or `apt install tmux` (Linux).

Weekly Installs228Repository[affaan-m/everyt…ude-code](https://github.com/affaan-m/everything-claude-code)GitHub Stars85.6KFirst Seen7 days agoSecurity Audits[Gen Agent Trust HubPass](/affaan-m/everything-claude-code/dmux-workflows/security/agent-trust-hub)[SocketPass](/affaan-m/everything-claude-code/dmux-workflows/security/socket)[SnykWarn](/affaan-m/everything-claude-code/dmux-workflows/security/snyk)Installed oncodex217cursor179gemini-cli177kimi-cli177github-copilot177opencode177

---
*Source: https://skills.yangsir.net/skill/daily-dmux-workflows*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-dmux-workflows/markdown*