Skip to content
Get packs

dmux Parallel Agent Workflows

Run and coordinate several AI agent sessions in parallel using dmux and tmux panes

Source Download skill
Repository
affaan-m/ECC
Stars
295,127
Licence
MIT
Files
2 files

What it does

This skill teaches an AI agent how to plan work across multiple parallel agent sessions managed by dmux, a tmux-based pane manager. When a task can be split into independent pieces, the agent suggests splitting it into panes (for example research, implementation, tests, and docs), explains how to start each pane with its own prompt, and recommends how to merge results and use git worktrees to avoid file conflicts. It is mostly guidance and example prompts rather than automated actions.

Great for

  • Developers who already use Claude Code, Codex, or similar agent tools and want to run several sessions at once
  • Teams splitting a large feature into independent parts that different agents can handle
  • People comfortable with a terminal, tmux, and git worktrees

Skip it if

  • Beginners who have not used a terminal or git, since setup and merging require those skills
  • Tasks with tightly dependent steps, where parallel agents tend to produce conflicting or wasted work
  • Users watching API costs closely, because every pane is a full agent session consuming tokens

Try asking

  • “Split this feature into three parallel tasks: schema, API endpoints, and UI components, and set up dmux panes for each”
  • “Use dmux to have one agent write tests while another fixes failing code”
  • “Run a security review, a performance review, and a test-coverage review of src/api in parallel panes”
Step-by-step guide: how to use dmux Parallel Agent WorkflowsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    dmux-workflows.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip dmux-workflows.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip dmux-workflows.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Only parallelize tasks that are independent; have the agent identify dependencies first
  • Keep the number of panes small (the skill suggests under 5-6) to control token use
  • Review each pane's output before merging, and use separate git worktrees for overlapping files

What's inside

  • agents/openai.yaml
  • SKILL.md

Redistributed unmodified from affaan-m/ECC under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.