Ein Agent arbeitet an einem Feature, ein zweiter behebt einen Bug, ein dritter schreibt Tests – theoretisch ein enormer Produktivitätsgewinn. Praktisch scheitert das oft daran, dass alle im selben Arbeitsverzeichnis Dateien ändern und sich gegenseitig stören. Git Worktrees lösen dieses Problem elegant: Jedes Worktree ist ein eigenes Verzeichnis mit eigenem Branch, aber gemeinsamer Git-Historie. Dieser Artikel zeigt, wie Sie parallele Agenten mit Worktrees organisieren und welche Stolpersteine Sie vorab ausräumen sollten.
Was Worktrees sind und warum sie passen
Ein Git-Repository kann mehrere Arbeitsverzeichnisse gleichzeitig haben. Mit dem Befehl git worktree add, gefolgt von einem Zielpfad und der Option für einen neuen Branch, entsteht ein zusätzliches Verzeichnis, in dem dieser Branch ausgecheckt ist. Alle Worktrees teilen sich dieselbe Objektdatenbank, sodass kein erneutes Klonen nötig ist und Commits sofort überall sichtbar sind.
Für Coding-Agenten ist das ideal. Jede Sitzung von Claude Code, Codex CLI oder einem anderen Agenten startet in ihrem eigenen Worktree und kann dort ungestört Dateien ändern, Tests laufen lassen und committen. Konflikte entstehen erst beim Zusammenführen und damit an einer Stelle, an der Sie sie bewusst lösen.
Ein Branch kann dabei immer nur in einem Worktree ausgecheckt sein. Das ist eine nützliche Schutzfunktion, denn sie verhindert, dass zwei Agenten versehentlich auf demselben Branch arbeiten.
Die praktischen Stolpersteine
Ein frisches Worktree enthält nur versionierte Dateien. Abhängigkeiten wie node_modules oder virtuelle Python-Umgebungen müssen neu installiert werden, und nicht versionierte Dateien wie lokale Umgebungsvariablen fehlen. Planen Sie deshalb ein kleines Setup-Skript ein, das ein neues Worktree arbeitsfähig macht.
Zweiter Klassiker sind Ports und gemeinsam genutzte Ressourcen. Wenn drei Agenten gleichzeitig den Entwicklungsserver auf demselben Port starten oder dieselbe lokale Datenbank migrieren, gibt es Chaos. Vergeben Sie pro Worktree eigene Ports und, wo nötig, eigene Datenbanken oder Schemas.
Drittens wächst der Speicherbedarf mit jedem Worktree, vor allem bei großen Abhängigkeitsbäumen. Räumen Sie abgeschlossene Worktrees konsequent mit git worktree remove auf.
Ein viertes Thema sind Git-Hooks und lokale Werkzeuge. Pre-Commit-Hooks laufen in jedem Worktree, können aber von Abhängigkeiten abhängen, die dort noch fehlen. Testen Sie Ihr Setup-Skript deshalb einmal vollständig, bevor Sie mehrere Agenten gleichzeitig starten.
Ein bewährter Ablauf
- Zerlegen Sie die Arbeit in unabhängige Aufgaben, die möglichst wenige gemeinsame Dateien berühren.
- Legen Sie pro Aufgabe ein Worktree mit eigenem Branch in einem gemeinsamen Ordner neben dem Hauptrepository an.
- Führen Sie in jedem Worktree das Setup-Skript aus, das Abhängigkeiten installiert, Umgebungsvariablen kopiert und einen freien Port setzt.
- Starten Sie in jedem Worktree eine eigene Agenten-Sitzung mit klarer Aufgabenbeschreibung und Akzeptanzkriterien.
- Prüfen Sie die Ergebnisse nacheinander, mergen Sie sie einzeln in den Hauptbranch und lassen Sie die Tests nach jedem Merge laufen.
- Entfernen Sie abgeschlossene Worktrees und löschen Sie die zugehörigen Branches.
Wie viele Agenten sind sinnvoll?
Der begrenzende Faktor ist selten die Technik, sondern Ihre Aufmerksamkeit. Jede Sitzung braucht gelegentlich eine Rückfrage, eine Freigabe oder eine Korrektur, und jedes Ergebnis muss geprüft werden. Viele erfahrene Entwicklerinnen und Entwickler arbeiten mit zwei bis vier parallelen Sitzungen, mehr lohnt sich meist nur bei sehr klar geschnittenen Aufgaben und guter Testabdeckung.
Hilfreich ist eine Kombination aus Aufgaben mit unterschiedlichem Bedarf an Aufmerksamkeit: eine anspruchsvolle Aufgabe, die Sie eng begleiten, und zwei Routineaufgaben, die weitgehend selbstständig laufen. Ergänzend können Cloud-Agenten wie der von Codex Aufgaben übernehmen, die gar keine lokale Umgebung benötigen.
Ein einfacher Trick hilft beim Überblick: Benennen Sie Worktree-Verzeichnisse und Branches nach der Ticketnummer und kennzeichnen Sie die Terminalfenster entsprechend. So wissen Sie bei Rückfragen sofort, um welche Aufgabe es geht, und vermeiden es, Anweisungen versehentlich in die falsche Sitzung zu schreiben.
Parallelität als Teamkompetenz
Paralleles Arbeiten mit Agenten verändert Planung, Review und Zusammenarbeit im Team. In den Agentic-Coding-Workshops von neooutput üben unsere AI Code Engineers solche Abläufe an Ihrer echten Codebasis, inklusive Setup-Skripten für Worktrees und Regeln für das Review. Wie das bei Ihnen aussehen könnte, klären wir gern in einem kostenlosen 15-Minuten-Erstgespräch.
Häufige Fragen
Funktionieren Worktrees mit allen Coding-Agenten?
Ja, denn für den Agenten ist ein Worktree einfach ein normales Projektverzeichnis. Claude Code, Codex CLI, Cursor, Aider und andere arbeiten darin wie in jedem anderen Repository. Einige Werkzeuge bieten zusätzlich eigene Unterstützung für Worktrees.
Was passiert mit lokalen Konfigurationsdateien?
Nicht versionierte Dateien wie lokale Umgebungsvariablen werden nicht automatisch übernommen. Kopieren Sie sie per Setup-Skript oder verwenden Sie einen Secret-Manager, damit jedes Worktree die nötige Konfiguration erhält.
Sind Worktrees besser als mehrere Klone?
Für parallele Agenten meist ja. Worktrees teilen sich die Git-Historie, sparen Speicher und machen Commits sofort in allen Verzeichnissen sichtbar. Mehrere Klone sind nur sinnvoll, wenn Sie Umgebungen strikt voneinander trennen müssen.