Дом

Skill

DevOps и CI/CD

dmux-workflows

affaan-m/ECC

Организуйте параллельные сеансы работы ИИ-агентов с помощью dmux — менеджера панелей tmux для наборов агентов, таких как Claude Code и Codex.

...Расширить все

Обновлено время 2 октября 2026 г.

# tmux # orchestration # parallel agents # multi agent # git worktree # dmux

Рабочие процессы dmux

Организуйте параллельные сеансы работы агентов ИИ с помощью dmux — менеджера панелей tmux для наборов агентов.

Когда следует активировать

Параллельное выполнение нескольких сеансов агентов
Координация работы между Claude Code, Codex и другими наборами агентов
Сложные задачи, для которых целесообразно использовать параллелизм по принципу «разделяй и властвуй»
Пользователь говорит «запустить параллельно», «разделить эту работу», «использовать dmux» или «мультиагент»

Что такое dmux

dmux — это инструмент оркестрации на основе tmux, который управляет панелями ИИ-агентов:

Нажмите n, чтобы создать новую панель с приглашением
Нажмите m, чтобы объединить вывод панели обратно в основную сессию
Поддерживает: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen

Установка: Установите dmux из его репозитория после ознакомления с описанием пакета. См. github.com/standardagents/dmux

Быстрый старт

# Запустите сессию dmux
dmux

# Создайте панели агентов (нажмите «n» в dmux, затем введите подсказку)
# Панель 1: «Реализуйте промежуточное ПО аутентификации в src/auth/»
# Панель 2: «Напишите тесты для сервиса пользователей»
# Панель 3: «Обновите документацию по API»

# Каждая панель запускает собственный сеанс агента
# Нажмите «m», чтобы объединить результаты обратно

Шаблоны рабочих процессов

Шаблон 1: Исследование + Реализация

Разделите исследование и реализацию на параллельные этапы:

Панель 1 (Исследование): «Изучите лучшие практики ограничения скорости в Node.js.
  Проверьте существующие библиотеки, сравните подходы и запишите результаты в
  /tmp/rate-limit-research.md»

Панель 2 (Реализация): «Реализуйте промежуточное ПО для ограничения скорости для нашего API на Express.
  Начните с базовой модели token bucket, мы доработаем её после завершения исследования».

# После завершения работы панели 1 объедините результаты с контекстом панели 2

Шаблон 2: Работа с несколькими файлами

Распределите работу между независимыми файлами:

Панель 1: «Создайте схему базы данных и миграции для функции биллинга»
Панель 2: «Создайте конечные точки API биллинга в src/api/billing/»
Панель 3: «Создайте компоненты пользовательского интерфейса панели управления биллингом»

# Объедините всё, затем выполните интеграцию в главной панели

Шаблон 3: Цикл «Тестирование + исправление»

Запускайте тесты в одной панели, исправляйте ошибки в другой:

Панель 1 (Watcher): «Запустить набор тестов в режиме наблюдения. При сбое тестов
  свести воедино информацию о сбоях».

Панель 2 (Fixer): «Исправить неудавшиеся тесты на основе сообщений об ошибках из панели 1»

Шаблон 4: Кросс-харнесс

Используйте разные инструменты ИИ для разных задач:

Панель 1 (Claude Code): «Проверить безопасность модуля аутентификации»
Панель 2 (Codex): «Рефакторить служебные функции для повышения производительности»
Панель 3 (Claude Code): «Написать E2E-тесты для процесса оформления заказа»

Шаблон 5: Конвейер рецензирования кода

Параллельные аспекты рецензирования:

Панель 1: «Проверить src/api/ на наличие уязвимостей безопасности»
Панель 2: «Проверить src/api/ на наличие проблем с производительностью»
Панель 3: «Проверить src/api/ на наличие пробелов в тестовом покрытии»

# Объединить все проверки в единый отчет

Интеграция с рабочими деревьями Git

Для задач, затрагивающих пересекающиеся файлы:

# Создайте рабочие деревья для изоляции
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD

# Запустите агенты в отдельных рабочих деревьях
# Панель 1: cd ../feature-auth && claude
# Панель 2: cd ../feature-billing && claude

# Слийте ветки по завершении работы
git merge feat/auth
git merge feat/billing

Дополнительные инструменты

Инструмент	Функции	Когда использовать
dmux	Управление панелями tmux для агентов	Параллельные сеансы агентов
Superset	Терминальная IDE для более чем 10 параллельных агентов	Масштабная оркестрация
Инструмент Claude Code Task	Создание субагентов внутри процесса	Программный параллелизм в рамках сеанса
Многоагентная система Codex	Встроенные роли агентов	Параллельная работа, специфичная для Codex

Помощник ECC

Теперь ECC включает в себя помощник для оркестрации внешних панелей tmux с отдельными рабочими деревьями git:

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

Пример файла plan.json:

{
  "sessionName": "skill-audit",
  "baseRef": "HEAD",
  "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
  "workers": [
    { "name": "docs-a", "task": "Исправить навыки 1–4 и написать заметки о передаче задачи." },
    { "name": "docs-b", "task": "Исправить навыки 5–8 и написать заметки о передаче задачи." }
  ]
}

Вспомогательная функция:

Создаёт одно рабочее дерево Git, привязанное к ветке, для каждого рабочего процесса
Опционально накладывает выбранные seedPaths из основного репозитория на рабочее дерево каждого работника
Создаёт файлы task.md, handoff.md и status.md для каждого работника в папке .orchestration//
Запускает сессию tmux с одной панелью на каждого рабочего
Запускает команду каждого рабочего процесса в отдельной панели
Оставляет главную панель свободной для оркестратора

Используйте seedPaths, когда рабочим процессам требуется доступ к измененным или неотслеживаемым локальным файлам, которые ещё не входят в HEAD, таким как локальные скрипты оркестрации, черновые планы или документация:

{
  "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": "Проверить наличие исходных файлов перед началом работы." }
  ]
}

Устранение неполадок

Панель не отвечает: переключитесь на панель напрямую или просмотрите её с помощью команды tmux capture-pane -pt :0..
Конфликты слияния: используйте git worktrees для изоляции изменений файлов в каждой панели.
Высокое использование токенов: Уменьшите количество параллельных панелей. Каждая панель представляет собой полноценный сеанс агента.
tmux не найден: Установите с помощью команды `brew install tmux ` (macOS) или `apt install tmux ` (Linux).

Посмотреть на GitHub

---
name: dmux-workflows
description: Orchestrate parallel AI agent sessions using dmux, a tmux pane manager for agent harnesses like Claude Code and Codex.
---

# dmux Workflows

Orchestrate parallel AI agent sessions using dmux, a tmux pane manager for agent harnesses.

## When to Activate

- Running multiple agent sessions in parallel
- Coordinating work across Claude Code, Codex, and other harnesses
- Complex tasks that benefit from divide-and-conquer parallelism
- User says "run in parallel", "split this work", "use dmux", or "multi-agent"

## What is dmux

dmux is a tmux-based orchestration tool that manages AI agent panes:
- Press `n` to create a new pane with a prompt
- Press `m` to merge pane output back to the main session
- Supports: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen

**Install:** Install dmux from its repository after reviewing the package. See [github.com/standardagents/dmux](https://github.com/standardagents/dmux)

## Quick Start

```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
```

## Workflow Patterns

### Pattern 1: Research + Implement

Split research and implementation into parallel tracks:

```
Pane 1 (Research): "Research best practices for rate limiting in Node.js.
  Check current libraries, compare approaches, and write findings to
  /tmp/rate-limit-research.md"

Pane 2 (Implement): "Implement rate limiting middleware for our Express API.
  Start with a basic token bucket, we'll refine after research completes."

# After Pane 1 completes, merge findings into Pane 2's context
```

### Pattern 2: Multi-File Feature

Parallelize work across independent files:

```
Pane 1: "Create the database schema and migrations for the billing feature"
Pane 2: "Build the billing API endpoints in src/api/billing/"
Pane 3: "Create the billing dashboard UI components"

# Merge all, then do integration in main pane
```

### Pattern 3: Test + Fix Loop

Run tests in one pane, fix in another:

```
Pane 1 (Watcher): "Run the test suite in watch mode. When tests fail,
  summarize the failures."

Pane 2 (Fixer): "Fix failing tests based on the error output from pane 1"
```

### Pattern 4: Cross-Harness

Use different AI tools for different tasks:

```
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"
```

### Pattern 5: Code Review Pipeline

Parallel review perspectives:

```
Pane 1: "Review src/api/ for security vulnerabilities"
Pane 2: "Review src/api/ for performance issues"
Pane 3: "Review src/api/ for test coverage gaps"

# Merge all reviews into a single report
```

## Best Practices

1. **Independent tasks only.** Don't parallelize tasks that depend on each other's output.
2. **Clear boundaries.** Each pane should work on distinct files or concerns.
3. **Merge strategically.** Review pane output before merging to avoid conflicts.
4. **Use git worktrees.** For file-conflict-prone work, use separate worktrees per pane.
5. **Resource awareness.** Each pane uses API tokens — keep total panes under 5-6.

## Git Worktree Integration

For tasks that touch overlapping files:

```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
```

## Complementary Tools

| Tool | What It Does | When to Use |
|------|-------------|-------------|
| **dmux** | tmux pane management for agents | Parallel agent sessions |
| **Superset** | Terminal IDE for 10+ parallel agents | Large-scale orchestration |
| **Claude Code Task tool** | In-process subagent spawning | Programmatic parallelism within a session |
| **Codex multi-agent** | Built-in agent roles | Codex-specific parallel work |

## ECC Helper

ECC now includes a helper for external tmux-pane orchestration with separate git worktrees:

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

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

The helper:
- Creates one branch-backed git worktree per worker
- Optionally overlays selected `seedPaths` from the main checkout into each worker worktree
- Writes per-worker `task.md`, `handoff.md`, and `status.md` files under `.orchestration/<session>/`
- Starts a tmux session with one pane per worker
- Launches each worker command in its own pane
- Leaves the main pane free for the orchestrator

Use `seedPaths` when workers need access to dirty or untracked local files that are not yet part of `HEAD`, such as local orchestration scripts, draft plans, or docs:

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

## Troubleshooting

- **Pane not responding:** Switch to the pane directly or inspect it with `tmux capture-pane -pt <session>:0.<pane-index>`.
- **Merge conflicts:** Use git worktrees to isolate file changes per pane.
- **High token usage:** Reduce number of parallel panes. Each pane is a full agent session.
- **tmux not found:** Install with `brew install tmux` (macOS) or `apt install tmux` (Linux).

Все файлы

1 файлов

dmux-workflows.md 6.2k

Просмотр

Установить dmux-workflows

Скачайте файлы навыков и распакуйте их в каталог .claude/skills/.

Скачать ZIP

Клонируйте репозиторий и скопируйте файлы навыка в свой проект.

git clone https://github.com/affaan-m/ECC/tree/main/skills/dmux-workflows # Copy SKILL.md to your .claude/skills/ directory

Копировать

Быстрая настройка: Скопируйте папку со скиллом в каталог .claude/skills/ Claude автоматически обнаружит и запустит этот скилл

Репозиторий affaan-m/ECC