← Zurück zum Blog
Aica. 6 Min. Lesezeit

Zehn Agenten parallel laufen lassen, und dein Git-Repo bricht zuerst

Veröffentlicht 7. Nov. 2026
Zehn Agenten parallel laufen lassen, und dein Git-Repo bricht zuerst

Der Pitch für Coding-Agenten war das ganze Jahr über gleich: Sie laufen unbeaufsichtigt, also sollte man mehrere gleichzeitig laufen lassen. Fünf, zehn, mehr. Einer am Auth-Refactoring, einer am flaky Test, einer an der Migration, die niemand anfassen will.

Das Tooling hält meistens. Dann probiert man es aus, und das, was bricht, ist das Arbeitsverzeichnis.

Zwei Agenten in einem Checkout überschreiben sich gegenseitig die Dateien innerhalb einer Minute. Die Lösung steckt seit 2015 in git: Worktrees, die jedem Branch ein eigenes Verzeichnis geben und dabei eine Objektdatenbank teilen. Git kann das. Die Schnittstelle von git dafür ist schlecht genug, dass die meisten sie nie benutzen.

Worktrunk ist ein Rust-CLI, das die Schnittstelle repariert. Es hat 11.900 Sterne, etwa 2.200 davon aus der letzten Woche, und es ist MIT oder Apache-2.0, je nachdem, was man bevorzugt.

Das Drei-Tippen-Problem

Ein Worktree in git anzulegen erfordert, den Branchnamen dreimal zu tippen:

git worktree add -b feat ../repo.feat cd ../repo.feat

Zwei von den dreien sind redundant. Sie existieren, weil der Befehl einen Pfad und einen Branch will, und der Pfad ist fast immer aus dem Branch ableitbar. Das klingt nach einem kleinen Ärgernis. Es ist der Grund, warum Worktrees eine Technik für Leute mit starken Meinungen geblieben sind statt ein Default.

Worktrunk adressiert Worktrees über den Branchnamen und berechnet den Pfad aus einem konfigurierbaren Template. Jeder Befehl, der einen Branch akzeptiert, akzeptiert auch den Pfad des Worktrees, der ihn hält. Aus dem unangenehmen Dreizeiler wird also:

wt switch -c -x claude feat

Einen Branch anlegen, seinen Worktree anlegen und Claude darin starten, von wo man gerade ist. Das -x Flag führt nach dem Wechsel einen Befehl aus. Alles, was man nach einem Trenner anhängt, wird an diesen Befehl durchgereicht, und so gibt man dem Agenten seine erste Anweisung:

wt switch -x claude -c feature-auth

Dreimal davon in einer Shell, und man hat drei Agenten auf drei Branches, isoliert, ohne jede Koordination zwischen ihnen.

Installation

Homebrew unter macOS oder Linux: brew install worktrunk && wt config shell install. Cargo, pacman, conda-forge und pixi funktionieren alle. Unter Windows ist es winget install max-sixty.worktrunk, gefolgt von git-wt config shell install.

Der Windows-Hinweis lohnt die Wiederholung, weil er jemanden erwischen wird: wt zeigt bereits auf Windows Terminal, also installiert Winget das Tool als git-wt, um die Kollision zu vermeiden. Man kann auch den Windows-Terminal-Alias in den App-Ausführungsaliasen deaktivieren und wt direkt verwenden.

Der Schritt config shell install ist nicht optional. Er installiert den Shell-Hook, der einen Befehl das aktuelle Verzeichnis wechseln lässt, und das ist der ganze Mechanismus hinter wt switch. Lässt man ihn weg, scheint jeder Befehl nichts zu tun.

Die Befehle, die zählen

Vier davon decken den größten Teil des Workflows ab.

wt switch bewegt einen. wt list zeigt jeden Worktree mit Statusmarkern: @ für den aktuellen Ort, + für gestagte Änderungen, ↑1 für einen Commit vor main, ⇡ für nicht gepushte Commits. Allein diese Ausgabe ist besser als git worktree list, das Pfade liefert und sonst nichts.

wt remove räumt auf und löscht Worktree und Branch zusammen, was in git zwei Befehle sind und eine Stelle, an der man es falsch macht.

wt merge main ist der interessante. Er squasht den aktuellen Branch, rebased ihn auf main, macht einen Fast-Forward und entfernt den Worktree, in einem Schritt. Wer schon einmal denselben Konflikt dreimal über drei parallele Branches hinweg aufgelöst hat, weiß, warum es das gibt. Parallelität multipliziert das Merge-Problem, und das Merge-Problem war ohnehin der unangenehmste Teil der Arbeit.

Es gibt außerdem wt switch pr:123, das direkt zum Branch hinter einem Pull Request springt. Kleines Feature, unverhältnismäßig viel Lebensqualität.

Speicher ist der Teil, vor dem niemand warnt

Zehn Worktrees heißt zehn Kopien von node_modules und zehn Kopien von target/. Auf einem Laptop sind das hunderte Gigabyte, und der erste cargo build in jedem dauert vier Minuten.

Worktrunk löst das mit Copy-on-Write-Build-Caches. Auf Dateisystemen, die es unterstützen, APFS unter macOS, btrfs und XFS mit Reflinks unter Linux, teilen die Worktrees das Build-Verzeichnis und divergieren erst, wenn sich eine Datei ändert. Der erste Build zahlt. Die nächsten neun leihen.

Das ist die Art Feature, die verrät, wofür der Autor das Tool tatsächlich benutzt. Niemand fügt einem Worktree-Manager geteilte Build-Caches aus Marketinggründen hinzu. Man fügt sie hinzu, nachdem die Festplatte zum vierten Mal vollgelaufen ist.

Das verwandte Detail ist hash_port, ein Template-Filter, der jedem Worktree einen eigenen Port gibt. Zehn Worktrees, zehn Dev-Server, keine Portkonflikte, keine manuelle Buchführung. Kombiniert mit einem Post-Start-Hook, der Abhängigkeiten installiert und den Server startet, ist ein neuer Worktree voll betriebsbereit in dem Moment, in dem der Agent startet.

Hooks sind die scharfe Kante

Hooks führen Shell-Befehle automatisch zu definierten Zeitpunkten aus: nachdem ein Worktree startet, vor einem Merge, nach einem Merge. Post-Start-Hooks sind der Weg, Umgebungseinrichtung gratis zu bekommen.

Sie sind auch beliebige Codeausführung, ausgelöst durch eine git-Operation. Ein Repository kann eine Konfiguration mitliefern, die bei wt switch etwas ausführt, und wenn man es klont und in einen Branch wechselt, hat man es ausgeführt. Das ist dieselbe Risikoklasse wie npm install, das ein postinstall-Skript ausführt, und es verdient dieselbe Behandlung: die Konfiguration lesen, bevor man dem Repo vertraut.

Die Antwort des Tools darauf ist, dass Hooks in einer Konfiguration deklariert werden, die man kontrolliert. Ob das reicht, hängt vom eigenen Bedrohungsmodell ab, und für alle, die fremde Repositories klonen, lohnt es einen Gedanken.

Was es nicht repariert

Worktrees teilen ein .git Verzeichnis, was heißt, sie teilen Branch-Referenzen, Stash und Konfiguration. Zwei Agenten können nicht denselben Branch auschecken. Ein git rebase in einem Worktree ändert Historie, auf der ein anderer Worktree sitzt. Reflog-Einträge verschränken sich auf eine Weise, die Forensik schwerer macht.

Worktrunk macht den Normalfall angenehm und ändert das zugrundeliegende Modell nicht. Wenn die Agenten wirklich unabhängige Repositories brauchen, will man getrennte Klone, und dann verliert man den geteilten Objektspeicher, der Worktrees überhaupt billig macht.

Es gibt außerdem ein Koordinationsproblem, das das Tool nicht anfasst. Zehn Agenten auf zehn Branches produzieren zehn Pull Requests, die dieselben drei Dateien anfassen, und keine Menge Worktree-Verwaltung lässt die sauber mergen. Die Teams, die Wert aus Parallelität ziehen, scheinen die zu sein, die disjunkte Bereiche vergeben, nicht die, die die meisten Agenten laufen lassen.

Warum diese Art Tool Aufmerksamkeit gewinnt

Agent-Frameworks bekommen die Ankündigungen. Die Utilities, die Agenten benutzbar machen, bekommen die Sterne.

Dieses Muster hat sich das ganze Jahr wiederholt: Memory-Schichten, Permission-Modi, Sandboxes, Worktree-Manager. Jedes existiert, weil das Modell gut genug wurde, die Arbeit zu tun, und die Umgebung nie für einen Arbeiter entworfen wurde, der nicht müde wird, keine Fragen stellt und fröhlich vierzig Minuten im falschen Verzeichnis läuft.

Worktrunk ist eine kleine, fokussierte Antwort auf eine dieser Lücken. Seine 11.900 Sterne zählen Entwickler, die versucht haben, drei Agenten gleichzeitig laufen zu lassen, und festgestellt haben, dass das Schwere das Dateisystem war.

Verwandte Artikel