dmux Workflows
Orchestrieren Sie parallele KI-Agenten-Sitzungen mit dmux, einem tmux-Pane-Manager für Agenten-Umgebungen.
Wann aktivieren
- Ausführung mehrerer Agenten-Sitzungen parallel
- Koordination von Arbeit über Claude Code, Codex und andere Umgebungen hinweg
- Komplexe Aufgaben, die von Teile-und-herrsche-Parallelismus profitieren
- Der Benutzer sagt "parallel ausführen", "diese Arbeit aufteilen", "dmux verwenden" oder "Multi-Agent"
Was ist dmux
dmux ist ein tmux-basiertes Orchestrierungswerkzeug, 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 geprüft haben. Siehe github.com/standardagents/dmux
Schnellstart
# dmux-Sitzung starten
dmux
# Agenten-Panes erstellen (drücken Sie 'n' in dmux, dann Eingabeaufforderung 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 seine eigene Agenten-Sitzung aus
# Drücken Sie 'm', um Ergebnisse zurückzuholen
Workflow-Muster
Muster 1: Research + Implementieren
Research und Implementierung in parallele Spuren aufteilen:
Pane 1 (Research): "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 (Implementieren): "Implementiere Rate-Limiting-Middleware für unsere Express-API.
Beginne mit einem einfachen Token Bucket, wir verfeinern es nach Abschluss der Recherche."
# Nach Abschluss von Pane 1 die Ergebnisse in den Kontext von Pane 2 übernehmen
Muster 2: Multi-Datei-Feature
Arbeit über unabhängige Dateien parallelisieren:
Pane 1: "Erstelle das Datenbankschema und die Migrationen für das Abrechnungs-Feature"
Pane 2: "Baue die Abrechnungs-API-Endpunkte in src/api/billing/"
Pane 3: "Erstelle die UI-Komponenten für das Abrechnungs-Dashboard"
# Alles zusammenführen, dann Integration im Haupt-Pane durchführen
Muster 3: Test + Fix-Schleife
Tests in einem Pane ausführen, Fehler in einem anderen beheben:
Pane 1 (Beobachter): "Führe die Testsuite im Watch-Modus aus. Wenn Tests fehlschlagen,
fasse die Fehler zusammen."
Pane 2 (Reparierer): "Behebe fehlschlagende Tests basierend auf der Fehlerausgabe von Pane 1"
Muster 4: Umgebungsübergreifend
Verschiedene KI-Tools für unterschiedliche Aufgaben verwenden:
Pane 1 (Claude Code): "Überprüfe die Sicherheit des Auth-Moduls"
Pane 2 (Codex): "Refaktoriere die Hilfsfunktionen für Performanz"
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 Sicherheitsschwachstellen"
Pane 2: "Überprüfe src/api/ auf Leistungsprobleme"
Pane 3: "Überprüfe src/api/ auf Testabdeckungslücken"
# Alle Reviews in einem einzigen Bericht zusammenführen
Best Practices
- Nur unabhängige Aufgaben. Parallelisieren Sie keine Aufgaben, die von der Ausgabe anderer abhängen.
- Klare Grenzen. Jedes Pane sollte an unterschiedlichen Dateien oder Themen arbeiten.
- Strategisch zusammenführen. Überprüfen Sie die Pane-Ausgabe vor dem Zusammenführen, um Konflikte zu vermeiden.
- Git Worktrees verwenden. Bei konfliktanfälligen Dateien pro Pane separate Worktrees verwenden.
- 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 bei Fertigstellung zusammenführen
git merge feat/auth
git merge feat/billing
Ergänzende Werkzeuge
| Werkzeug | Was es tut | Wann verwenden |
|---|---|---|
| dmux | tmux-Pane-Verwaltung für Agenten | Parallele Agenten-Sitzungen |
| Superset | Terminal-IDE für 10+ parallele Agenten | Großflächige Orchestrierung |
| Claude Code Task-Werkzeug | Untergeordnete Sub-Agenten-Erzeugung im Prozess | Programmatische Parallelität innerhalb einer Sitzung |
| Codex Multi-Agent | Integrierte Agenten-Rollen | Codex-spezifische parallele Arbeit |
ECC-Helfer
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 pro Worker ein branch-gestütztes Git-Worktree
- Überlagert optional ausgewählte
seedPathsaus dem Haupt-Checkout 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 frei für den Orchestrator
Verwenden Sie seedPaths, wenn Worker Zugriff auf geänderte oder nicht versionierte lokale Dateien benötigen, die noch nicht Teil von HEAD sind, wie 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 eingepflegten Dateien vor Arbeitsbeginn vorhanden sind." }
]
}
Fehlerbehebung
- Pane antwortet 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 Agenten-Sitzung.
- tmux nicht gefunden: Installieren Sie mit
brew install tmux(macOS) oderapt install tmux(Linux).