Worktrunk: Git-Worktrees für parallele KI-Agenten
Worktrunk ist ein Kommandozeilenwerkzeug, das Git-Worktrees so einfach macht wie Branches. Damit lassen sich mehrere Coding-Agenten parallel im selben Repository arbeiten, ohne sich gegenseitig Dateien zu überschreiben. Wir haben es installiert und einen ganzen Ablauf vom Anlegen bis zum Merge getestet.
Worktrunk ist ein Kommandozeilenwerkzeug für Git-Worktrees, das speziell für das parallele Arbeiten mit KI-Agenten gebaut wurde. Statt mit mehreren Git-Befehlen einen Ordner anzulegen, hineinzuwechseln und später wieder aufzuräumen, genügt ein Befehl pro Schritt, und die Ordner werden über den Branch-Namen angesprochen.
Ein Worktree ist ein zusätzlicher Arbeitsordner desselben Git-Repositorys, in dem ein anderer Branch ausgecheckt ist. Die Grundlagen zu GitGit ist ein Versionskontrollsystem, das jede Änderung am Code einer Software oder Website mit Zeitpunkt, Autor und Beschreibung speichert. Damit lassen sich…Mehr erfahren → erklärt unser Glossar unter Git-Versionskontrolle.
Warum Worktrunk gerade so gefragt ist
Das Repository max-sixty/worktrunk wurde am 17.10.2025 angelegt und hat 10'817 Sterne, laut GitHub-Trending rund 750 davon in der letzten Woche (Stand 04.11.2026, Quelle GitHub). Laut README wurde Worktrunk Anfang 2026 veröffentlicht. Der Bedarf kommt aus der Praxis: Coding-Agenten wie Claude Code oder Codex arbeiten inzwischen lange ohne Aufsicht, und wer drei oder vier davon gleichzeitig laufen lässt, braucht getrennte Arbeitsordner. Die aktuelle Version 0.81.0 erschien am 20.10.2026, der letzte Commit ist vom 04.11.2026.
So funktioniert es
Worktrunk ist eine Hülle um die Git-Funktion git worktree mit drei Kernbefehlen:
| Aufgabe | Worktrunk | reines Git |
|---|---|---|
| Neuen Arbeitsordner anlegen und hineinwechseln | wt switch --create feat | git worktree add -b feat ../repo.feat und cd ../repo.feat |
| Wechseln | wt switch feat | cd ../repo.feat |
| Übersicht mit Status | wt list | git worktree list (nur Pfade) |
| Zurückführen und aufräumen | wt merge | Commit, Rebase, Merge, git worktree remove, git branch -d |
Dazu kommen laut README Hooks für automatische Einrichtung (etwa Abhängigkeiten installieren), KI-generierte Commit-Nachrichten, ein Plugin für Claude Code und gemeinsam genutzte Build-Caches. Für parallele Agenten zeigt das README:
wt switch -x claude -c feature-a -- 'Add user authentication'
wt switch -x claude -c feature-b -- 'Fix the pagination bug'
Der Schalter -x startet nach dem Wechsel ein Programm, hier Claude Code mit der Aufgabe als Argument.
Installation
Laut README:
brew install worktrunk && wt config shell install
# oder
cargo install worktrunk && wt config shell install
Wir wollten nichts systemweit installieren und haben das Release-Archiv für macOS von GitHub geladen und die Prüfsumme kontrolliert:
gh release download v0.81.0 -R max-sixty/worktrunk -p 'worktrunk-aarch64-apple-darwin.tar.xz*'
shasum -a 256 -c worktrunk-aarch64-apple-darwin.tar.xz.sha256
tar xf worktrunk-aarch64-apple-darwin.tar.xz
wt --version
Wichtig ist die Shell-Integration: Ohne sie meldet wt switch «Cannot change directory — shell integration not installed», weil ein Programm den Ordner der aufrufenden Shell nicht selbst wechseln darf. wt config shell install ergänzt dafür eine Zeile in der .zshrc. Im Test haben wir das in einem eigenen Home-Verzeichnis gemacht.
Unser Test
Testobjekt war ein kleines Repository «holzwerk-website» einer fiktiven Schreinerei. Wir haben zwei Aufgaben simuliert, wie sie zwei Agenten parallel bearbeiten würden: ein Offertenformular und eine Rabattaktion.
Der Ablauf im Einzelnen:
wt switch --create offertenformularlegte Branch und Ordnerholzwerk-website.offertenformularneben dem Hauptordner an und wechselte hinein.- Nach einer neuen Datei legte
wt switch --create rabatt-aktion --base mainden zweiten Ordner an. wt listzeigte alle drei Arbeitsordner, welcher Änderungen hat und wie sie zumainstehen.wt merge -yim Ordner offertenformular hat die neue Datei automatisch hinzugefügt, einen Commit erstellt, nachmainzusammengeführt, den Arbeitsordner samt Branch im Hintergrund entfernt und zurück in den Hauptordner gewechselt.- Ein zweites
wt listzeigte nur nochmainund die Rabattaktion, jetzt mit dem Hinweis, dass sie einen Commit hintermainliegt.
Was gut war: Die Befehle sind kurz und die Ausgaben sagen genau, was passiert. Der Merge räumt vollständig auf, es blieben keine verwaisten Ordner oder Branches. Das spart genau die Handgriffe, die man bei parallelen Agenten sonst vergisst.
Hilfreich ist auch, dass wt list auf einen Blick zeigt, welcher Arbeitsordner Änderungen hat, wie weit er von main entfernt ist und welcher Commit zuletzt dazukam. Bei drei oder vier gleichzeitig laufenden Agenten ersetzt das manuelles Durchklicken durch die Ordner. Die Ordnernamen folgen einem festen Muster, Repository-Name plus Branch, das sich laut README über eine Vorlage anpassen lässt. Weil Worktrunk nur reines Git verwendet, bleiben alle Worktrees auch ohne das Werkzeug normal nutzbar: Wer es wieder entfernt, verliert nichts.
Was auffiel: Ohne konfiguriertes Sprachmodell schreibt wt merge eine generische Commit-Nachricht («Changes to offerte.htmlHTML (Hypertext Markup Language) ist die Auszeichnungssprache, mit der der Inhalt und die Struktur jeder Webseite beschrieben werden: Überschriften, Absätze,…Mehr erfahren →»). Wer saubere Historien will, richtet die KI-Commit-Nachrichten ein oder committet vorher selbst. Standardmässig wird beim Merge alles hinzugefügt, auch ungetrackte Dateien; mit --stage tracked lässt sich das einschränken.
Nicht getestet: echte parallele Agenten mit -x claude, Hooks, KI-Commit-Nachrichten, das Claude-Code-Plugin und die gemeinsamen Build-Caches.
Beispiele aus der Praxis
- Mehrere Agenten an einer Kunden-Website: Ein Agent baut das neue Formular, ein zweiter überarbeitet die Texte, ein dritter schreibt Tests. Jeder in seinem Ordner, am Ende werden nur die geprüften Ergebnisse zusammengeführt.
- Varianten vergleichen: Dieselbe Aufgabe zweimal in getrennten Ordnern lösen lassen, beide ansehen und nur die bessere Variante übernehmen.
- Dringender Fix während laufender Arbeit: Ein Hotfix in einem frischen Ordner von
main, ohne die halbfertige Arbeit im Hauptordner anzufassen.
Grenzen, Risiken, Lizenz
Lizenz: Die Datei LICENSE stellt MIT und Apache-2.0 zur Wahl, Cargo.toml schreibt «MIT OR Apache-2.0». GitHub kann diese Kombination nicht automatisch einer Lizenz zuordnen und zeigt NOASSERTION. Beide Lizenzen erlauben die kommerzielle Nutzung.
Datenschutz: Worktrunk selbst arbeitet lokal mit Git. Nur wer KI-Commit-Nachrichten oder Zusammenfassungen einschaltet, schickt Diffs an das dafür konfigurierte Modell.
Sicherheit: Hooks in einer Projektkonfiguration führen Befehle automatisch aus. Laut Plugin-Beschreibung laufen nur «approved» Hooks des Projekts. Das Claude-Code-Plugin erlaubt zudem den Wechsel in passende Worktrees ohne Rückfrage. Bei fremden Repositorys sollte man die Konfiguration vorher lesen.
Ressourcen: Jeder Worktree ist ein vollständiger Arbeitsordner. Bei grossen Projekten mit node_modules kostet das Platz, dafür gibt es laut README die Copy-on-write-Caches.
Für wen lohnt sich Worktrunk?
Für Entwickler und Agenturen, die mehr als einen Coding-Agenten gleichzeitig einsetzen oder oft zwischen Aufgaben wechseln. Wer nur mit einem Agenten nacheinander arbeitet, kommt mit normalen Branches aus. Wie mehrere Agenten im Vergleich arbeiten, zeigt unser Beitrag OpenAI Codex vs. Claude Code. Wenn Sie eine Web-AppEine Web-App ist eine Anwendung, die im Browser läuft und sich wie ein Programm bedienen lässt — mit Login, Eingaben, gespeicherten Daten und Abläufen. Anders…Mehr erfahren → mit diesem Arbeitsmodell entwickeln lassen möchten, finden Sie mehr auf der Seite Web-App entwickeln lassen.
Weitere Werkzeuge aus diesem Monat finden Sie in der Übersicht alle 20 GitHub-Trends vom November 2026.
Häufige Fragen
Was ist Worktrunk?+
Worktrunk ist ein Kommandozeilenwerkzeug namens wt für die Verwaltung von Git-Worktrees. Es legt pro Aufgabe einen eigenen Arbeitsordner mit eigenem Branch an, zeigt alle Ordner mit ihrem Stand an und führt Änderungen mit einem Befehl zurück in den Hauptbranch.
Wofür braucht man Git-Worktrees bei KI-Agenten?+
Wenn zwei Agenten im selben Ordner arbeiten, überschreiben sie sich gegenseitig Dateien. Ein Worktree ist ein zusätzlicher Arbeitsordner desselben Repositorys mit eigenem Branch. So kann jeder Agent isoliert arbeiten, und man führt am Ende nur die guten Ergebnisse zusammen.
Wie installiere ich Worktrunk?+
Laut README mit Homebrew (brew install worktrunk) oder Cargo (cargo install worktrunk), danach wt config shell install für die Shell-Integration. Unter Windows gibt es ein winget-Paket. Wir haben das signierte Release-Archiv von GitHub verwendet und die Prüfsumme kontrolliert.
Ist Worktrunk kostenlos?+
Ja. Worktrunk steht wahlweise unter MIT oder Apache-2.0. Kosten entstehen nur, wenn man die optionalen KI-Commit-Nachrichten oder Zusammenfassungen über einen kostenpflichtigen Modellanbieter nutzt.
Über den Autor
Daniel MüllerSenior Developer & SEO-Stratege
Daniel Müller ist Senior Developer und SEO-Stratege bei DLM Digital in Zürich. Mit über 10 Jahren Erfahrung in Webentwicklung, SEO, GEO/AEO und KI-Integration begleitet er Schweizer KMU bei der digitalen Transformation. Im DLM Magazin schreibt er über KI, Vibe Coding und moderne Suchmaschinen-Sichtbarkeit.
