Een Git-worktree geeft elke Cursor-agent een eigen checkout: een aparte werkmap met een eigen branch. Dat voorkomt dat agents in dezelfde checkout elkaars bestanden overschrijven, maar wijzigingen uit verschillende branches moeten later nog worden geïntegreerd en gecontroleerd.

Gebruik worktrees om gelijktijdig werk te scheiden; behandel het samenvoegen van branches als een aparte stap.

Wat worktrees isoleren en waar conflicten ontstaan

Een worktree is een aparte checkout van dezelfde Git-repository. Agents kunnen daarin onafhankelijk aan bestanden werken, zonder één gedeelde werkmap te gebruiken. Maar twee branches kunnen nog steeds dezelfde regels code aanpassen. Zodra je de wijzigingen samenvoegt, kan Git bij overlappende edits om een oplossing vragen. Niet-overlappende wijzigingen kan Git combineren.

Een merge zonder tekstconflicten is ook geen bewijs dat het gecombineerde programma goed werkt. Twee wijzigingen kunnen elkaar inhoudelijk bijten, bijvoorbeeld als de ene een functie hernoemt en de andere nog de oude naam aanroept. Bekijk daarom de samengevoegde wijzigingen en voer passende tests uit. De Git-handleiding over mergeconflicten beschrijft zowel overlappende wijzigingen als fouten die na een schone merge kunnen blijven bestaan.

Cursor-worktrees: Agents Window, IDE en configuratie

Cursor biedt de ingebouwde worktree-interface in de Agents Window. In de IDE beschrijft Cursor Worktree Skills, met opdrachten als /worktree en /best-of-n. Bij /best-of-n draaien kandidaatmodellen in afzonderlijke worktrees; Cursor voegt hun wijzigingen niet automatisch samen. Je kiest een resultaat en past dat zelf toe.

Je kunt de voorbereiding van een worktree aanpassen met .cursor/worktrees.json. Daarin zijn algemene en besturingssysteemspecifieke setup-opdrachten mogelijk, als opdrachtenreeksen of als scriptpad. Cursor zoekt het bestand eerst in de worktree en daarna in de projectmap. De Cursor-documentatie over worktrees beschrijft ook de overige IDE-opdrachten en configuratieopties.

Automatische opruiming kan handmatige worktrees meenemen

Voor Cursor 3.5 en later beschrijft Cursor automatische opruiming met een standaardmaximum van 25 worktrees per machine. Ook worktrees die je zelf met git worktree add hebt gemaakt, komen daarvoor in aanmerking. De documentatie geeft zes uur als voorbeeld voor een opruiminterval; dat is een voorbeeldinstelling, geen interval dat voor iedere installatie geldt.

Ga er dus niet van uit dat een handmatig aangemaakte worktree buiten Cursor-opruiming valt. Bewaar werk dat je wilt behouden in de repository voordat je op opruiming vertrouwt.

Wat Cursor-support adviseerde bij een onderbroken agent

Op 10 september 2026 schreef Cursor-support dat het aanmaken van een worktree en het tijdens een taak verplaatsen van de agent naar die map een agentbeurt kan onderbreken. Het advies was om de agent meteen te starten in de map waar het werk moet gebeuren. Support schreef ook dat je met ‘continue’ een gestopte taak kunt hervatten. De reactie van Cursor-support ging in op een gemelde onderbreking tijdens het wisselen van worktree.