Back to Skills

dmux-workflows

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.

184,214stars28,424forksUpdated 5/16/2026

Security Assessment

Safe(100/100)
Security Score100/100

About dmux-workflows

The dmux-workflows skill provides a structured approach to orchestrating multiple AI agent sessions in parallel using dmux, a tmux-based pane manager designed specifically for coordinating agent harnesses. It addresses the challenge of working with complex development tasks that benefit from parallel execution, where a single AI session may be too slow or limited in scope. By enabling multiple agents to run concurrently in isolated panes, it allows users to divide large problems into smaller, independently executable units while maintaining a coordinated workflow.

This skill leverages dmux’s pane-based interface to manage multiple AI tools such as Claude Code, Codex, OpenCode, Cline, Gemini, and Qwen. Users can spawn new panes, assign focused prompts, and later merge outputs back into a central session. It supports structured workflow patterns including research-and-implement separation, multi-file feature development, test-and-fix loops, cross-harness collaboration, and parallel code review pipelines. It also integrates with development best practices such as using git worktrees for isolation when working on overlapping codebases, ensuring safe parallel execution without file conflicts.

dmux-workflows is intended for developers, AI engineers, and teams building complex software systems who want to accelerate delivery through parallel agent coordination. It is particularly useful for tasks like feature development, large-scale refactoring, test generation, documentation writing, and security or performance reviews. By enabling divide-and-conquer execution across multiple AI agents, it improves productivity, reduces iteration time, and provides a scalable structure for managing multi-agent AI development workflows.

FAQ

When should I use dmux-workflows instead of a single AI session?

Use dmux-workflows when tasks can be split into independent parts, such as different files, research vs implementation, or separate review concerns. It is especially useful when parallel execution can reduce total completion time.

Which AI tools are compatible with dmux-workflows?

The workflow supports multiple agent harnesses including Claude Code, Codex, OpenCode, Cline, Gemini, and Qwen, allowing different tools to be assigned to different panes.

What are the main limitations of using dmux-workflows?

The main limitation is that tasks must be independent to avoid conflicts. Additionally, managing too many panes can increase complexity and resource usage, so it is generally recommended to keep the number of active panes under five to six.

Do I need special setup to use dmux-workflows?

Yes, dmux must be installed from its repository before use. It operates within a tmux environment and requires basic setup of your preferred agent tools.

Install dmux-workflows

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill