dmux Workflows
Orchestrieren Sie parallele KI-Agentensitzungen mit dmux, einem tmux-Pane-Manager für Agentenumgebungen.
Wann aktivieren
- Mehrere Agentensitzungen parallel ausführen
- Arbeit über Claude Code, Codex und andere Umgebungen hinweg koordinieren
- Komplexe Aufgaben, die von einem Divide-and-Conquer-Ansatz profitieren
- Benutzer sagt „parallel ausführen“, „diese Arbeit aufteilen“, „dmux verwenden“ oder „Multi-Agent“
Was ist dmux
dmux ist ein Orchestrierungswerkzeug auf Basis von tmux, das KI-Agenten-Panes verwaltet:
- Drücken Sie
n, um ein neues Pane mit einer Eingabeaufforderung zu erstellen - Drücken Sie
m, um die Pane-Ausgabe zurück in die Hauptsitzung zu übernehmen - Unterstützt: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen
Installation: Installieren Sie dmux aus seinem Repository, nachdem Sie das Paket überprüft haben. Siehe github.com/standardagents/dmux
Schnellstart
# dmux-Sitzung starten
dmux
# Agenten-Panes erstellen (in dmux 'n' drücken, dann Eingabe eingeben)
# Pane 1: „Implementiere die Auth-Middleware in src/auth/“
# Pane 2: „Schreibe Tests für den User-Service“
# Pane 3: „Aktualisiere die API-Dokumentation“
# Jedes Pane führt eine eigene Agentensitzung aus
# Drücken Sie 'm', um die Ergebnisse zurückzuführen
Workflow-Muster
Muster 1: Recherchieren + Implementieren
Aufteilung von Recherche und Implementierung auf parallele Spuren:
Pane 1 (Recherche): „Recherchiere Best Practices für Rate Limiting in Node.js.
Überprüfe aktuelle Bibliotheken, vergleiche Ansätze und schreibe die Ergebnisse nach
/tmp/rate-limit-research.md“
Pane 2 (Implementierung): „Implementiere Rate-Limiting-Middleware für unsere Express-API.
Beginne mit einem einfachen Token Bucket, wir verfeinern nach Abschluss der Recherche.“
# Nach Abschluss von Pane 1: Ergebnisse in den Kontext von Pane 2 einfließen lassen
Muster 2: Multi-Datei-Feature
Parallelisieren der Arbeit über unabhängige Dateien:
Pane 1: „Erstelle das Datenbankschema und die Migrationen für das Billing-Feature“
Pane 2: „Baue die Billing-API-Endpunkte in src/api/billing/“
Pane 3: „Erstelle die UI-Komponenten für das Billing-Dashboard“
# Alles zusammenführen, dann Integration im Haupt-Pane durchführen
Muster 3: Testen + Beheben-Schleife
Tests in einem Pane ausführen, Fehler in einem anderen beheben:
Pane 1 (Watcher): „Führe die Testsuite im Watch-Modus aus. Wenn Tests fehlschlagen,
fasse die Fehler zusammen.“
Pane 2 (Fixer): „Behebe fehlschlagende Tests basierend auf der Fehlerausgabe aus Pane 1“
Muster 4: Cross-Harness
Verschiedene KI-Tools für unterschiedliche Aufgaben nutzen:
Pane 1 (Claude Code): „Überprüfe die Sicherheit des Auth-Moduls“
Pane 2 (Codex): „Refaktoriere die Hilfsfunktionen für bessere Performance“
Pane 3 (Claude Code): „Schreibe E2E-Tests für den Checkout-Ablauf“
Muster 5: Code-Review-Pipeline
Parallele Review-Perspektiven:
Pane 1: „Überprüfe src/api/ auf Sicherheitslücken“
Pane 2: „Überprüfe src/api/ auf Performance-Probleme“
Pane 3: „Überprüfe src/api/ auf Lücken in der Testabdeckung“
# Alle Reviews in einem einzigen Bericht zusammenführen
Best Practices
- Nur unabhängige Aufgaben. Parallelisieren Sie keine Aufgaben, die von den Ergebnissen anderer abhängen.
- Klare Grenzen. Jedes Pane sollte an eigenen Dateien oder Bereichen arbeiten.
- Strategisch zusammenführen. Überprüfen Sie die Pane-Ausgabe vor dem Zusammenführen, um Konflikte zu vermeiden.
- Git Worktrees verwenden. Bei konfliktanfälligen Dateiarbeiten separate Worktrees pro Pane nutzen.
- Ressourcenbewusstsein. Jedes Pane verbraucht API-Token – halten Sie die Gesamtzahl der Panes unter 5–6.
Git Worktree Integration
Für Aufgaben, die sich überschneidende Dateien betreffen:
# Worktrees zur Isolation erstellen
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD
# Agenten in separaten Worktrees ausführen
# Pane 1: cd ../feature-auth && claude
# Pane 2: cd ../feature-billing && claude
# Branches nach Abschluss zusammenführen
git merge feat/auth
git merge feat/billing
Komplementäre Werkzeuge
| Werkzeug | Was es macht | Wann verwenden |
|---|---|---|
| dmux | tmux-Pane-Verwaltung für Agenten | Parallele Agentensitzungen |
| Superset | Terminal-IDE für 10+ parallele Agenten | Großflächige Orchestrierung |
| Claude Code Task Tool | Subagent-Erzeugung innerhalb des Prozesses | Programmatische Parallelität in einer Sitzung |
| Codex multi-agent | Integrierte Agentenrollen | Codex-spezifische parallele Arbeit |
ECC-Helper
ECC enthält jetzt einen Helfer für die externe tmux-Pane-Orchestrierung mit separaten Git-Worktrees:
node scripts/orchestrate-worktrees.js plan.json --execute
Beispiel plan.json:
{
"sessionName": "skill-audit",
"baseRef": "HEAD",
"launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
"workers": [
{ "name": "docs-a", "task": "Behebe Skills 1–4 und schreibe Übergabenotizen." },
{ "name": "docs-b", "task": "Behebe Skills 5–8 und schreibe Übergabenotizen." }
]
}
Der Helfer:
- Erstellt ein branch-gestütztes Git-Worktree pro Worker
- Optionale Überlagerung ausgewählter
seedPathsaus dem Hauptcheckout in jedes Worker-Worktree - Schreibt pro Worker
task.md-,handoff.md- undstatus.md-Dateien unter.orchestration/<session>/ - Startet eine tmux-Sitzung mit einem Pane pro Worker
- Startet jeden Worker-Befehl in seinem eigenen Pane
- Lässt das Haupt-Pane für den Orchestrator frei
Verwenden Sie seedPaths, wenn Worker Zugriff auf schmutzige oder nicht versionierte lokale Dateien benötigen, die noch nicht Teil von HEAD sind, z. B. lokale Orchestrierungsskripte, Entwurfspläne oder Dokumente:
{
"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": "Überprüfe, ob die eingepflanzten Dateien vor Arbeitsbeginn vorhanden sind." }
]
}
Fehlerbehebung
- Pane reagiert nicht: Wechseln Sie direkt zum Pane oder überprüfen Sie es mit
tmux capture-pane -pt <session>:0.<pane-index>. - Merge-Konflikte: Verwenden Sie Git-Worktrees, um Dateiänderungen pro Pane zu isolieren.
- Hoher Token-Verbrauch: Reduzieren Sie die Anzahl paralleler Panes. Jedes Pane ist eine vollständige Agentensitzung.
- tmux nicht gefunden: Installieren Sie mit
brew install tmux(macOS) oderapt install tmux(Linux).