Drei Agenten, ein Repo – und ein drohender Zusammenstoß
Mehrere AI-Agenten auf einem einzigen Git-Checkout laufen zu lassen, ist ein vorprogrammierter Konflikt. Agent A, mitten in einem Refactoring, bringt plötzlich die Tests von Agent B zum Scheitern, aufgrund geteilter Abhängigkeiten oder sich überschneidender Dateiänderungen. Dieses Problem des geteilten Ordners lähmt die parallele Entwicklung.
Git worktrees bieten eine sofortige Lösung: Jede Aufgabe erhält ein isoliertes Verzeichnis, einen eigenen Branch und einen sauberen Arbeitsbereich. Dieser zweite Checkout teilt sich die Historie des Repositorys, aber die Agenten schreiben nicht mehr auf demselben Blatt Papier. Es ist ein mächtiges Grundelement für die Parallelisierung von Arbeit.
Allerdings bringen einfache Git worktrees ihre eigene Reibung mit sich. Das Erstellen erfordert, den Branch-Namen dreimal einzutippen, gefolgt von manuellen Verzeichniswechseln. Das Aufräumen erfordert drei weitere Befehle, um den Worktree und seinen Branch zu löschen.
Darüber hinaus liefert eine Statusabfrage bei Git nur eine statische Liste von Ordnerpfaden. Es gibt keine einheitliche, dynamische Ansicht darüber, was jeder Agent gerade tut, keinen integrierten Merge-Befehl, und Abhängigkeiten bleiben ein manuelles Anliegen. Native Worktree-Unterstützung, wie bei Claude Code, behebt zwar die Erstellung, lässt aber diese kritischen Lücken offen.
Der Ein-Zeilen-Workflow, der das Jonglieren mit Ordnern ersetzt
Worktrunk optimiert parallele Agenten-Workflows, indem der Fokus von Ordnerpfaden auf Branches verlagert wird. wt switch <branch> erstellt einen Worktree oder wechselt in einen, wodurch das Eintippen von Branch-Namen oder das Merken von Verzeichnispfaden entfällt. Dieser einzige Befehl richtet eine isolierte Umgebung für jeden Agenten ein.
wt list bietet ein konsolidiertes, interaktives Dashboard. Es zeigt jeden aktiven Worktree an, inklusive Branch, Fortschritt relativ zu main, Diff-Größe und Indikatoren für die Agentenaktivität (z. B. ein Roboter-Symbol für aktive Agenten, eine Sprechblase für Agenten, die auf Input warten). Dies ersetzt die statischen Ordnerpfade von git worktree list durch handlungsorientierten Kontext.
Wenn ein Agent seine Aufgabe beendet hat, automatisiert wt merge einen komplexen, sechsstufigen Git-Lebenszyklus in einem Befehl. Es committet, squasht, rebased auf main, führt einen Fast-Forward aus und löscht den abgeschlossenen Worktree sowie dessen Branch. Während wt merge den Großteil der Arbeit automatisiert, stoppen Konflikte weiterhin den Rebase und erfordern menschliches Eingreifen.
Der Geschwindigkeitstrick: Wiederverwenden, was jeder Agent braucht
Das Ausführen mehrerer Agenten erfordert ein effizientes Setup. Worktrunk bietet Lifecycle-Hooks, die Setup-Aufgaben automatisch ausführen, wenn ein Worktree erstellt wird. Dies eliminiert wiederholte Installationen von Abhängigkeiten und manuelle Konfigurationen der Umgebung und stellt sicher, dass jeder Agent produktiv startet.
Worktrunk geht auch Speicherplatz- und Geschwindigkeitsfragen mit wt step copy-ignored an. Dieser Befehl verwendet ignorierte Dateien wie node_modules oder Build-Caches wieder. Auf unterstützten Dateisystemen (APFS, Btrfs) nutzt er copy-on-write, wobei auf die Originaldateien verlinkt wird, bis Änderungen auftreten. Dies spart erheblich Speicherplatz und Zeit.
Das Video demonstriert beeindruckende Ergebnisse: Ein 14 GB großer Rust-Build-Ordner wurde mit copy-ignored in ca. 20 Sekunden kopiert, im Vergleich zu 2 Minuten auf normalem Weg. Ein erster Rust-Build sank von 68 Sekunden auf 3-4 Sekunden. Dies sind vom Autor gemeldete Zeiten, keine universellen Benchmarks. Die Unterstützung des Dateisystems ist entscheidend; EXT4 unter Linux führt vollständige Kopien durch. Außerdem müssen native Module weiterhin neu gebaut werden. Für weitere Details zum Ansatz von Worktrunk bei parallelen Agenten-Workflows, besuchen Sie Worktrunk — Git worktree management for parallel AI agent workflows.
Gefällt Ihnen der Artikel? Erhalten Sie jeden Morgen einen wie diesen per E-Mail.
eine E-Mail pro Tag · Abmeldung mit zwei Klicks · kein Tracking durch Dritte
Nützlich, schnelllebig – und nicht für jeden Entwickler geeignet
Die terminal-basierte Orchestrierung von Worktrunk steht in starkem Kontrast zu den nativen Claude Code Worktrees. Während Claude Code grundlegende Isolierung und automatische Bereinigung übernimmt, überlässt es die Statusüberwachung und Merge-Workflows dem Benutzer. Worktrunk schließt diese Lücke und bietet eine einheitliche Ansicht aller Agentenaktivitäten sowie einen Ein-Befehl-Merge, der Commits, Squashes, Rebases und das Löschen von Worktrees abwickelt.
Dieses kleine CLI befindet sich in einer Phase vor 1.0 (derzeit v0.81), was bedeutet, dass häufige Breaking Changes auftreten können; rechnen Sie damit, Ihre Konfiguration aktualisieren zu müssen. Die Shell-Funktions-Einrichtung für den Verzeichniswechsel ist ebenso entscheidend wie die Überprüfung von Projekt-Hooks, die Shell-Befehle ausführen. Ungelöste Merge-Konflikte erfordern weiterhin manuelle Eingriffe; Worktrunk stoppt den Rebase und übergibt Ihnen die Kontrolle.
Die Vorteile von Copy-on-Write durch wt step copy-ignored hängen vom Dateisystem ab. Auf APFS ist es nahezu sofort verfügbar und spart erheblich Platz, während EXT4 Linux-Systeme vollständige Kopien erstellen. Native Module müssen bei neuen Worktrees weiterhin neu erstellt werden.
Wenn Sie jeweils nur einen Agenten ausführen, sind native Worktrees oder einfaches Git wahrscheinlich ausreichend. Wenn Sie jedoch regelmäßig drei, fünf oder mehr Agenten ausführen und den Worktree-Overhead reduzieren müssen – von der Einrichtung und Abhängigkeitsinstallation bis hin zu Statusprüfungen und Merge-Bereinigungen –, bietet Worktrunk die fehlende Orchestrierungsebene.
Häufig gestellte Fragen
Was ist Worktrunk?
Worktrunk ist ein Open-Source-CLI, das die Git Worktree-Verwaltung für Entwickler vereinfacht, die parallele Programmieraufgaben oder KI-Agenten ausführen.
Wie hilft Worktrunk bei parallelen KI-Agenten?
Es weist jeder Aufgabe einen eigenen Branch und Checkout zu, zeigt den Worktree-Status in einer Ansicht an und optimiert das Mergen und die Bereinigung.
Funktioniert Worktrunk nur mit Claude Code?
Nein. Es lässt sich in Claude Code integrieren und unterstützt andere Agenten-CLIs, einschließlich Codex, OpenCode und Gemini CLI.
Beseitigt Worktrunk Merge-Konflikte?
Nein. Worktrees isolieren Dateien während der Entwicklung, aber sich überschneidende Änderungen können beim Mergen dennoch zu Konflikten führen.
Ist Worktrunk produktionsreif?
Es befindet sich in einer Phase vor 1.0, daher sind mögliche Breaking Changes zu erwarten. Überprüfen Sie Projekt-Hooks, bevor Sie deren Shell-Befehle genehmigen.