dmux-workflows

Orchestrates parallel AI agent sessions across tmux panes using dmux.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ibytechaos/claude --skill dmux-workflows-ibytechaos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dmux-workflows
Source: https://github.com/ibytechaos/claude/tree/main/plugins/everything-claude-code/skills/dmux-workflows
Command: npx skills add https://github.com/ibytechaos/claude --skill dmux-workflows-ibytechaos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple AI agent sessions manually is chaotic and error-prone. This Skill provides structured patterns for running parallel agent workflows across Claude Code, Codex, OpenCode, and other harnesses using dmux, a tmux-based pane manager. ## Core Features & Use Cases - Parallel Workflow Patterns: Five ready-made patterns including research+implement, multi-file features, test+fix loops, cross-harness work, and parallel code review. - Git Worktree Isolation: Instructions for isolating file changes per agent using git worktrees to avoid merge conflicts. - Worktree Orchestration Helper: A plan.json-driven script that creates branch-backed worktrees, per-worker task files, and tmux panes automatically. - Use Case: Split a large feature into three independent tasks, run each in its own agent pane with its own worktree, then merge the results back into the main branch. ## Quick Start Ask the agent to split the current task into parallel dmux panes, for example by saying "run these three independent tasks in parallel with dmux 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 agents in parallel with dmux?

Start a dmux session, press 'n' to create a new pane, and type a prompt for each agent. Each pane runs its own agent session, and you press 'm' to merge pane output back to the main session.

What tasks work well with parallel agent workflows?

Independent tasks with clear boundaries work best, such as splitting research from implementation, parallelizing work across separate files, or running security, performance, and test-coverage reviews simultaneously. Avoid tasks that depend on each other's output.

Which AI coding tools does dmux support?

dmux supports Claude Code, Codex, OpenCode, Cline, Gemini, and Qwen. You can mix harnesses across panes, assigning different tools to different subtasks in a cross-harness workflow.

How do I avoid merge conflicts with parallel agents?

Use git worktrees to give each agent its own branch-backed working directory. The orchestration helper automates this by creating one worktree per worker from a plan.json file, then merging branches when work completes.

What are the limitations of running parallel agent panes?

Each pane is a full agent session consuming API tokens, so keep total panes under five or six. Parallelism also fails when tasks share files or depend on each other's output, so boundaries must be explicit.