Agent skill

Dmux Workflows

by affaan-m in affaan-m/ECC

使用dmux(AI代理的tmux窗格管理器)进行多代理编排。跨Claude Code、Codex、OpenCode及其他工具的并行代理工作流模式。适用于并行运行多个代理会话或协调多代理开发工作流时。

MITAuto-check passedAgent Workflows

Install Dmux Workflows

skills CLI
$ npx skills add affaan-m/ECC --skill dmux-workflows -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install affaan-m/ECC dmux-workflows --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/zh-CN/skills/dmux-workflows .claude/skills/dmux-workflows && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dmux-workflows
GitHub stars
277k
Used in
2 other repos
Token cost
~1k tokens
SKILL.md length
176 words
Files
1
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

使用dmux(AI代理的tmux窗格管理器)进行多代理编排。跨Claude Code、Codex、OpenCode及其他工具的并行代理工作流模式。适用于并行运行多个代理会话或协调多代理开发工作流时。

  • Works in 5 steps: 仅限独立任务。 不要并行化相互依赖输出的任务。 → 明确边界。 每个窗格应处理不同的文件或关注点。 → 策略性合并。 合并前审查窗格输出以避免冲突。 → …
  • Tasks that involve Git worktrees
  • SKILL.md covers 何时激活, 什么是 dmux, 快速开始 and 工作流模式, plus 5 more sections
  • Calls git, node and npm

What it does

Dmux Workflows is an agent skill from affaan-m/ECC. 使用dmux(AI代理的tmux窗格管理器)进行多代理编排。跨Claude Code、Codex、OpenCode及其他工具的并行代理工作流模式。适用于并行运行多个代理会话或协调多代理开发工作流时。

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Git worktrees. It works with tmux and Git. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • Tasks that involve Git worktrees

Example prompts

  • “/dmux-workflows”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 仅限独立任务。 不要并行化相互依赖输出的任务。
  2. 明确边界。 每个窗格应处理不同的文件或关注点。
  3. 策略性合并。 合并前审查窗格输出以避免冲突。
  4. 使用 git worktree。 对于容易产生文件冲突的工作,为每个窗格使用单独的工作树。
  5. 资源意识。 每个窗格都消耗 API 令牌 —— 将总窗格数控制在 5-6 个以下。

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • node
    • npm
    • brew
    • apt

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dmux Workflows loads about 1k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 176 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 176 words, ~1,023 tokens.

Download SKILL.mdSave it as .claude/skills/dmux-workflows/SKILL.md (or your agent's skills folder).
name
dmux-workflows
description
使用dmux(AI代理的tmux窗格管理器)进行多代理编排。跨Claude Code、Codex、OpenCode及其他工具的并行代理工作流模式。适用于并行运行多个代理会话或协调多代理开发工作流时。
origin
ECC

dmux 工作流

使用 dmux(一个用于代理套件的 tmux 窗格管理器)来编排并行的 AI 代理会话。

何时激活

  • 并行运行多个代理会话时
  • 跨 Claude Code、Codex 和其他套件协调工作时
  • 需要分而治之并行处理的复杂任务
  • 用户提到“并行运行”、“拆分此工作”、“使用 dmux”或“多代理”时

什么是 dmux

dmux 是一个基于 tmux 的编排工具,用于管理 AI 代理窗格:

  • 按 n 创建一个带有提示的新窗格
  • 按 m 将窗格输出合并回主会话
  • 支持:Claude Code、Codex、OpenCode、Cline、Gemini、Qwen

安装: npm install -g dmux 或参见 github.com/standardagents/dmux

快速开始

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

工作流模式

模式 1:研究 + 实现

将研究和实现拆分为并行轨道:

Pane 1 (Research): "研究 Node.js 中速率限制的最佳实践。
  检查当前可用的库,比较不同方法,并将研究结果写入
  /tmp/rate-limit-research.md"

Pane 2 (Implement): "为我们的 Express API 实现速率限制中间件。
  先从基本的令牌桶算法开始,研究完成后我们将进一步优化。"

# Pane 1 完成后,将研究结果合并到 Pane 2 的上下文中
模式 2:多文件功能

在独立文件间并行工作:

Pane 1: "创建计费功能的数据库模式和迁移"
Pane 2: "在 src/api/billing/ 中构建计费 API 端点"
Pane 3: "创建计费仪表板 UI 组件"

# 合并所有内容,然后在主面板中进行集成
模式 3:测试 + 修复循环

在一个窗格中运行测试,在另一个窗格中修复:

窗格 1(观察者):“在监视模式下运行测试套件。当测试失败时,
  总结失败原因。”

窗格 2(修复者):“根据窗格 1 的错误输出修复失败的测试”
模式 4:跨套件

为不同任务使用不同的 AI 工具:

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"
模式 5:代码审查流水线

并行审查视角:

Pane 1: "审查 src/api/ 中的安全漏洞"
Pane 2: "审查 src/api/ 中的性能问题"
Pane 3: "审查 src/api/ 中的测试覆盖缺口"

# 将所有审查合并为一份报告

最佳实践

  1. 仅限独立任务。 不要并行化相互依赖输出的任务。
  2. 明确边界。 每个窗格应处理不同的文件或关注点。
  3. 策略性合并。 合并前审查窗格输出以避免冲突。
  4. 使用 git worktree。 对于容易产生文件冲突的工作,为每个窗格使用单独的工作树。
  5. 资源意识。 每个窗格都消耗 API 令牌 —— 将总窗格数控制在 5-6 个以下。

Git Worktree 集成

对于涉及重叠文件的任务:

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

互补工具

工具功能使用时机
dmux用于代理的 tmux 窗格管理并行代理会话
Superset用于 10+ 并行代理的终端 IDE大规模编排
Claude Code Task 工具进程内子代理生成会话内的程序化并行
Codex 多代理内置代理角色Codex 特定的并行工作

ECC 助手

ECC 现在包含一个助手,用于使用独立的 git worktree 进行外部 tmux 窗格编排:

bash
node scripts/orchestrate-worktrees.js plan.json --execute

示例 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." }
  ]
}

该助手:

  • 为每个工作器创建一个基于分支的 git worktree
  • 可选择将主检出中的选定 seedPaths 覆盖到每个工作器的工作树中
  • 在 .orchestration/<session>/ 下写入每个工作器的 task.md、handoff.md 和 status.md 文件
  • 启动一个 tmux 会话,每个工作器一个窗格
  • 在每个窗格中启动相应的工作器命令
  • 为主协调器保留主窗格空闲

当工作器需要访问尚未纳入 HEAD 的脏文件或未跟踪的本地文件(例如本地编排脚本、草案计划或文档)时,使用 seedPaths:

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." }
  ]
}

故障排除

  • 窗格无响应: 直接切换到该窗格或使用 tmux capture-pane -pt <session>:0.<pane-index> 检查它。
  • 合并冲突: 使用 git worktree 隔离每个窗格的文件更改。
  • 令牌使用量高: 减少并行窗格数量。每个窗格都是一个完整的代理会话。
  • 未找到 tmux: 使用 brew install tmux (macOS) 或 apt install tmux (Linux) 安装。

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/zh-CN/skills/dmux-workflows of affaan-m/ECC.

Open the folder on GitHubat commit 2d515e4

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in affaan-m/ECC, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Dmux Workflows next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dmux Workflows compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dmux Workflows this skillaffaan-m/ECC277k2 repos~1kAutomated safety check: PassMIT
Agent Deckasheshgoplani/agent-deck1.1k—~1.8kAutomated safety check: PassMIT
Clawteamwin4r/ClawTeam-OpenClaw1.5k—~3.1kAutomated safety check: PassMIT
Huashu Agent Swarmalchaincyf/huashu-skills1.7k—~576Automated safety check: PassMIT
Agtx Task Sweepfynnfluegge/agtx1.7k—~1.7kAutomated safety check: PassApache-2.0
Mori Agent Bridgevaayne/mori303—~1.7kAutomated safety check: PassMIT

Similar skills

  • Agent Deck

    asheshgoplani/agent-deck

    agent-deck, the terminal session manager for AI coding agents.

    1.1k GitHub stars~1.8k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Clawteam

    win4r/ClawTeam-OpenClaw

    Multi-agent swarm orchestration. An agent skill from win4r/ClawTeam-OpenClaw.

    1.5k GitHub stars~3.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Huashu Agent Swarm

    alchaincyf/huashu-skills

    多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

    1.7k GitHub stars~576 tokensUpdated 18 days ago
    Agent WorkflowsAuto-check passed
  • Agtx Task Sweep

    fynnfluegge/agtx

    Breaks a conversation's results into feature-level tasks and pushes them to the agtx kanban board, where each task gets its own worktree and agent session.

    1.7k GitHub stars~1.7k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Use Mori CLI to enable agent-to-agent communication and coordination across Mori-managed panes.

    303 GitHub stars~1.7k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Project Session Manager

    Yeachan-Heo/oh-my-claudecode

    Creates isolated git worktrees, with optional tmux sessions, for PR reviews, issue fixes and feature work across projects and repositories.

    40k GitHub stars~4k tokensUpdated 2 days ago
    DevelopmentAuto-check passed

More from affaan-m/ECC

All 682 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Works with

Categories

Questions about Dmux Workflows

What does Dmux Workflows do?

使用dmux(AI代理的tmux窗格管理器)进行多代理编排。跨Claude Code、Codex、OpenCode及其他工具的并行代理工作流模式。适用于并行运行多个代理会话或协调多代理开发工作流时。. Dmux Workflows is an agent skill from affaan-m/ECC.

When should I use Dmux Workflows?

Dmux Workflows fits situations like: tasks that involve Git worktrees.

How do I install Dmux Workflows in Claude Code?

Run `npx skills add affaan-m/ECC --skill dmux-workflows -a claude-code`. Or copy the skill folder (docs/zh-CN/skills/dmux-workflows in affaan-m/ECC) into .claude/skills/dmux-workflows in your project. Claude Code loads it when a task matches its description.

How do I install Dmux Workflows in Codex?

Run `npx skills add affaan-m/ECC --skill dmux-workflows -a codex`. Or copy the skill folder (docs/zh-CN/skills/dmux-workflows in affaan-m/ECC) into .agents/skills/dmux-workflows in your project. Codex loads it when a task matches its description.

Can I use Dmux Workflows in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill dmux-workflows -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dmux-workflows, .gemini/skills/dmux-workflows, .github/skills/dmux-workflows and .opencode/skills/dmux-workflows in your project.

What does Dmux Workflows need to run?

Going by SKILL.md and its folder, Dmux Workflows needs the command-line tools its instructions call (git, node, npm, brew and apt). Our summary lists: Node.js.

Does Dmux Workflows access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Dmux Workflows safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dmux Workflows use?

Dmux Workflows is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dmux Workflows use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dmux Workflows?

Skills that share tags, products or a category with Dmux Workflows: Agent Deck (asheshgoplani/agent-deck, 1.1k stars), Clawteam (win4r/ClawTeam-OpenClaw, 1.5k stars), Huashu Agent Swarm (alchaincyf/huashu-skills, 1.7k stars) and Agtx Task Sweep (fynnfluegge/agtx, 1.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dmux Workflows?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.