Git-Worktrees geben Cursor-Agenten getrennte Arbeitskopien. Änderungen in verschiedenen Branches können beim Zusammenführen trotzdem kollidieren oder im Ergebnis Fehler verursachen. Cursor bietet dafür unterschiedliche Arbeitswege im Agents Window und in der IDE; auch manuell angelegte Worktrees können in die automatische Bereinigung fallen.

Getrennte Checkouts verhindern Änderungen im selben Arbeitsordner. Den Merge und das Ergebnis musst du trotzdem prüfen.

Was ein Worktree trennt und was beim Merge bleibt

Ein Worktree ist eine eigene Arbeitskopie eines Git-Repositories. Mehrere Agenten können damit in getrennten Ordnern arbeiten, statt dieselben Dateien in einer gemeinsamen Arbeitskopie zu verändern.

Das verhindert nicht, dass ihre Branches dieselben Zeilen oder Funktionen bearbeiten. Beim Zusammenführen kann Git überlappende Änderungen als Konflikt melden. Nicht überlappende Textänderungen lassen sich oft kombinieren, aber auch ein konfliktfreier Merge beweist nicht, dass das Programm danach fachlich korrekt läuft. Änderungen prüfen und Tests ausführen bleiben deshalb Teil des Integrationsschritts. Git erklärt, wann Änderungen beim Merge kollidieren können und warum ein sauberer Merge trotzdem Fehler enthalten kann.

Auch Cursor führt nicht automatisch alle Kandidaten aus /best-of-n zusammen: Jeder Lauf erhält einen eigenen Worktree. Du vergleichst die Ergebnisse und wählst eines aus, das du anschließend anwendest. Cursor beschreibt die Worktree-Funktionen und ihren Ablauf in der Dokumentation.

Cursor-Worktrees im Agents Window und in der IDE

Die native Worktree-Oberfläche von Cursor gehört zum Agents Window. In der IDE dokumentiert Cursor stattdessen Worktree-Skills mit Befehlen wie /worktree, /best-of-n, /apply-worktree und /delete-worktree.

Für wiederkehrende Vorbereitungen kannst du .cursor/worktrees.json verwenden. Cursor unterstützt darin allgemeine sowie Unix- und Windows-spezifische Setup-Einträge; sie können Befehlslisten oder Skriptpfade enthalten. Die Suche nach der Datei beginnt im Worktree und geht danach zum Projektstammverzeichnis. So lassen sich passende Einrichtungsschritte für neue Worktrees festlegen, ohne sie bei jedem Start von Hand auszuführen.

Cursor kann auch manuell angelegte Worktrees bereinigen

Für Cursor 3.5 und neuere Versionen nennt Cursor eine standardmäßige Obergrenze von 25 Worktrees pro Rechner. Die automatische Bereinigung kann auch Worktrees erfassen, die du mit git worktree add selbst angelegt hast. Ein manuell erstellter Worktree ist also nicht automatisch von dieser Bereinigung ausgenommen. Die Cursor-Dokumentation beschreibt die Bereinigung und ihren Geltungsbereich.

Wenn ein Agent beim Worktree-Wechsel unterbrochen wird

In einer Antwort vom 10. September 2026 erklärte Cursor-Mitarbeiter Mohit Jain, dass das Anlegen eines Worktrees und der Wechsel des Agenten in diesen Ordner mitten in einer Aufgabe den laufenden Durchlauf unterbrechen könne. Als Ausweg empfahl er, den Agenten von Beginn an im Ordner starten zu lassen, in dem er arbeiten soll. Nach einem gestoppten Durchlauf könne der Befehl „continue“ die Aufgabe fortsetzen. Jains Antwort im Cursor-Forum bezog sich auf eine damalige Fehlermeldung zu diesem Ablauf.