dmux-workflows

Orchestrates parallel AI agent sessions across tmux panes using dmux.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill dmux-workflows-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dmux-workflows
Source: https://github.com/diazMelgarejo/orama-system/tree/main/.cursor/.agents/skills/dmux-workflows
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill dmux-workflows-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dmux, tmux.

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 with dmux, a tmux pane manager, so you can divide complex tasks across Claude Code, Codex, OpenCode, and other harnesses without losing track of results. ## Core Features & Use Cases - Parallel Workflow Patterns: Five ready-made patterns including research-plus-implement, multi-file features, test-and-fix loops, cross-harness execution, and parallel code review. - Git Worktree Integration: Isolate file changes per agent pane using git worktrees to prevent merge conflicts when panes touch overlapping files. - Merge and Troubleshooting Guidance: Best practices for merging pane output, managing token usage, and resolving common tmux or pane issues. - Use Case: You need to ship a billing feature fast. Spawn three dmux panes—one for database migrations, one for API endpoints, one for UI components—then merge the results and integrate in the main session. ## Quick Start Ask the agent to split your current task into parallel dmux panes, for example by saying "use dmux to run the auth implementation and the test writing in parallel panes".

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?

Install dmux with npm install -g dmux, start a session by running dmux, then 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 output back to the main session.

What tasks should I parallelize across agent panes?

Parallelize only independent tasks with clear boundaries, such as separate files, research versus implementation, or parallel code reviews. Avoid splitting tasks that depend on each other's output, and keep total panes under five or six to control token usage.

Which AI coding tools does dmux support?

dmux supports Claude Code, Codex, OpenCode, Cline, Gemini, and Qwen as agent harnesses. You can mix harnesses across panes, for example running a security review in Claude Code while Codex refactors utilities in another pane.

How do I avoid merge conflicts when agents edit the same files?

Use git worktrees to give each pane an isolated working copy, for example git worktree add ../feature-auth feat/auth. Run each agent in its own worktree directory, then merge the branches together when the parallel work completes.

Why is my dmux pane not responding?

A pane may be waiting for input from its agent session. Press m to read the pane's output and check its state. If tmux itself is missing, install it with brew install tmux on macOS or apt install tmux on Linux.