Ce face agent --worktree (worktree-uri din CLI)
-w sau --worktree [name] rulează Agent într-un worktree Git nou, nu direct în checkout-ul tău. Cursor îl creează în ~/.cursor/worktrees/<reponame>/<name>, lângă worktree-urile create din editor; fără nume, generează unul. Curățarea folosește aceleași reguli de păstrare ca în editor.
--worktree-base alege ramura sau ref-ul de pornire (implicit HEAD-ul curent), iar --skip-worktree-setup sare peste scripturile de setup din .cursor/worktrees.json. Cu --workspace <path> indici explicit rădăcina repository-ului; altfel CLI-ul folosește directorul curent.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
-w, --worktree [name] |
Worktree nou; numele e opțional. |
--worktree-base <branch> |
Ramura sau ref-ul de bază. |
--skip-worktree-setup |
Fără scripturile din .cursor/worktrees.json. |
--workspace <path> |
Rădăcina repository-ului. |
Exemple practice
Exemplul 1: Worktree cu nume generat
agent --worktree "upgrade the test runner and fix any broken snapshots"Exemplul 2: Worktree cu nume, din alt repository
agent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"Greșeli frecvente și bune practici
- Cauți modificările în checkout-ul principal. Ele sunt în worktree, sub
~/.cursor/worktrees. - Folosești worktree-uri într-un workspace multi-root. Documentația spune că funcțiile care depind de o singură rădăcină Git, ca worktree-urile, sunt dezactivate acolo.