dmux-Workflows

Koordinieren Sie parallele KI-Agenten-Sitzungen mit dmux, einem tmux-Fenstermanager für Agenten-Harnesses.

Wann aktivieren?

• Wenn mehrere Agent-Sitzungen parallel ausgeführt werden
• Koordination der Arbeit zwischen Claude Code, Codex und anderen Harnesses
• Komplexe Aufgaben, die von einer Parallelisierung nach dem „Teile und herrsche“-Prinzip profitieren
• Der Benutzer sagt „parallel ausführen“, „diese Arbeit aufteilen“, „dmux verwenden“ oder „Multi-Agent“

Was ist dmux?

dmux ist ein auf tmux basierendes Orchestrierungstool, das KI-Agenten-Fenster verwaltet:

• Drücke n, um einen neuen Bereich mit einer Eingabeaufforderung zu erstellen
• Drücke m, um die Ausgabe des Fensters wieder in die Hauptsitzung zu integrieren
• Unterstützt: Claude Code, Codex, OpenCode, Cline, Gemini, Qwen

Installation: Installieren Sie dmux aus dem Repository, nachdem Sie das Paket geprüft haben. Siehe github.com/standardagents/dmux

Schnellstart

# dmux-Sitzung starten
dmux

# Agent-Fenster erstellen (in dmux die Taste „n“ drücken, dann die Eingabeaufforderung eingeben)
# Fenster 1: „Implementiere die Authentifizierungs-Middleware in src/auth/“
# Fenster 2: „Schreibe Tests für den Benutzerservice“
# Fenster 3: „Aktualisiere die API-Dokumentation“

# Jedes Fenster führt eine eigene Agent-Sitzung aus
# Drücke „m“, um die Ergebnisse wieder zusammenzuführen

Workflow-Muster

Muster 1: Recherche + Implementierung

Recherche und Implementierung in parallele Arbeitsstränge aufteilen:

Fenster 1 (Recherche): „Recherchiere Best Practices für die Ratenbegrenzung in Node.js.
  Überprüfe aktuelle Bibliotheken, vergleiche Ansätze und schreibe die Ergebnisse in
  /tmp/rate-limit-research.md“

Fenster 2 (Implementierung): „Implementiere Middleware zur Ratenbegrenzung für unsere Express-API.
  Beginne mit einem einfachen Token-Bucket, den wir nach Abschluss der Recherche verfeinern werden.“

# Nachdem Fenster 1 abgeschlossen ist, füge die Ergebnisse in den Kontext von Fenster 2 ein

Muster 2: Funktion mit mehreren Dateien

Parallelisierung der Arbeit über unabhängige Dateien hinweg:

Bereich 1: „Erstelle das Datenbankschema und die Migrationen für die Abrechnungsfunktion“
Bereich 2: „Erstelle die Endpunkte der Abrechnungs-API in src/api/billing/“
Bereich 3: „Erstelle die UI-Komponenten für das Abrechnungs-Dashboard“

# Füge alles zusammen und führe anschließend die Integration im Hauptbereich durch

Muster 3: Test- und Korrekturzyklus

Tests in einem Fenster ausführen, Fehlerbehebung in einem anderen:

Fenster 1 (Watcher): „Führe die Testsuite im Überwachungsmodus aus. Wenn Tests fehlschlagen,
  fasse die Fehler zusammen.“

Fenster 2 (Fixer): „Behebe fehlgeschlagene Tests anhand der Fehlerausgabe aus Fenster 1“

Muster 4: Cross-Harness

Verschiedene KI-Tools für unterschiedliche Aufgaben einsetzen:

Fenster 1 (Claude Code): „Überprüfe die Sicherheit des Authentifizierungsmoduls“
Fenster 2 (Codex): „Refaktoriere die Hilfsfunktionen zur Leistungsoptimierung“
Fenster 3 (Claude Code): „Schreibe E2E-Tests für den Checkout-Ablauf“

Muster 5: Code-Review-Pipeline

Parallele Überprüfungsansätze:

Fenster 1: „Überprüfe src/api/ auf Sicherheitslücken“
Fenster 2: „Überprüfe src/api/ auf Leistungsprobleme“
Fenster 3: „Überprüfe src/api/ auf Lücken in der Testabdeckung“

# Füge alle Überprüfungen zu einem einzigen Bericht zusammen

Bewährte Vorgehensweisen

1. Nur unabhängige Aufgaben. Parallelisieren Sie keine Aufgaben, die von den Ergebnissen anderer Aufgaben abhängen.
2. Klare Abgrenzungen. Jeder Bereich sollte sich mit unterschiedlichen Dateien oder Aspekten befassen.
3. Strategisch zusammenführen. Überprüfen Sie die Ergebnisse der Überprüfungsbereiche vor dem Zusammenführen, um Konflikte zu vermeiden.
4. Verwenden Sie Git-Worktrees. Verwenden Sie bei Arbeiten, bei denen es leicht zu Dateikonflikten kommen kann, separate Worktrees pro Bereich.
5. Ressourcenbewusstsein. Jeder Bereich verwendet API-Token – die Gesamtzahl der Bereiche sollte unter 5–6 bleiben.

Git-Worktree-Integration

Für Aufgaben, die sich auf überlappende Dateien beziehen:

# Erstellen Sie Worktrees zur Isolierung
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD

# Agenten in separaten Worktrees ausführen
# Fenster 1: cd ../feature-auth && claude
# Fenster 2: cd ../feature-billing && claude

# Zweige nach Abschluss zusammenführen
git merge feat/auth
git merge feat/billing

Ergänzende Tools

ECC-Helfer

ECC enthält nun einen Helfer für die externe tmux-Pane-Orchestrierung mit separaten Git-Worktrees:

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

Beispiel für plan.json:

{
  "sessionName": "skill-audit",
  "baseRef": "HEAD",
  "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
  "workers": [
    { "name": "docs-a", "task": "Skills 1–4 korrigieren und Übergabehinweise verfassen." },
    { "name": "docs-b", "task": "Skills 5–8 korrigieren und Übergabehinweise verfassen." }
  ]
}

Der Helfer:

• Erstellt pro Worker einen durch einen Branch gestützten Git-Worktree
• Überlagert optional ausgewählte seedPaths aus dem Haupt-Checkout in den Worktree jedes Workers
• Schreibt die Dateien „task.md“, „handoff.md“ und „status.md“ pro Worker unter „.orchestration//“
• Startet eine tmux-Sitzung mit einem Fenster pro Worker
• Startet jeden Worker-Befehl in einem eigenen Fenster
• Hält das Hauptfenster für den Orchestrator frei

Verwenden Sie `seedPaths`, wenn Worker Zugriff auf geänderte oder nicht verfolgte lokale Dateien benötigen, die noch nicht Teil von HEAD sind, wie z. B. lokale Orchestrierungsskripte, Planentwürfe 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üfen, ob die Seed-Dateien vor Arbeitsbeginn vorhanden sind." }
  ]
}

Fehlerbehebung

• Fenster reagiert nicht: Wechseln Sie direkt zu dem Fenster oder überprüfen Sie es mit ` tmux capture-pane -pt :0`..
• Zusammenführungskonflikte: Verwenden Sie Git-Worktrees, um Dateiänderungen pro Fenster zu isolieren.
• Hohe Token-Auslastung: Reduzieren Sie die Anzahl der parallelen Fenster. Jedes Fenster entspricht einer vollständigen Agent-Sitzung.
• tmux nicht gefunden: Installieren Sie es mit `brew install tmux ` (macOS) oder `apt install tmux ` (Linux).