affaan-m/everything-claude-code/dmux-workflows

Claude Code and agent skill by affaan-m/everything-claude-code

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Multi-agent orchestration using dmux (tmux pane manager for AI agents). Patterns for parallel agent workflows across Claude Code, Codex, OpenCode, and other harnesses. Use when running multiple agent sessions in parallel or coordinating multi-agent development workflows.

Install

npx vskill@latest install affaan-m/everything-claude-code/dmux-workflows

SKILL.md

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: Install dmux from its repository after reviewing the package. See github.com/standardagents/dmux

Quick Start

bash
# 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

  1. Independent tasks only. Don't parallelize tasks that depend on each other's output.
  2. Clear boundaries. Each pane should work on distinct files or concerns.
  3. Merge strategically. Review pane output before merging to avoid conflicts.
  4. Use git worktrees. For file-conflict-prone work, use separate worktrees per pane.
  5. Resource awareness. Each pane uses API tokens — keep total panes under 5-6.

Git Worktree Integration

For tasks that touch overlapping files:

bash
# 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

ToolWhat It DoesWhen to Use
dmuxtmux pane management for agentsParallel agent sessions
SupersetTerminal IDE for 10+ parallel agentsLarge-scale orchestration
Claude Code Task toolIn-process subagent spawningProgrammatic parallelism within a session
Codex multi-agentBuilt-in agent rolesCodex-specific parallel work

ECC Helper

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

bash
# Use the configured plugin root or standalone install (~/.claude or
# $CLAUDE_CONFIG_DIR). For a reviewed and explicitly authorized ECC checkout:
# export CLAUDE_PLUGIN_ROOT="/absolute/path/to/reviewed/ECC"
ECC_ROOT="${CLAUDE_PLUGIN_ROOT:-${CLAUDE_CONFIG_DIR:-$HOME/.claude}}"
[ -f "$ECC_ROOT/scripts/orchestrate-worktrees.js" ] || { echo "ECC scripts not found in the selected root (set CLAUDE_PLUGIN_ROOT to an authorized ECC checkout)" >&2; exit 1; }
node "$ECC_ROOT/scripts/orchestrate-worktrees.js" plan.json --execute

Example plan.json:

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:

json
{
"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).

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
109,610
Repository forks
14,297
Repository npm downloads, 7 days
1,103
7-day trend score
75

Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 23 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/affaan-m/everything-claude-code/dmux-workflows/badge)](https://verified-skill.com/skills/affaan-m/everything-claude-code/dmux-workflows)

Something wrong with this skill or its page? Tell us.