#cursor#cli#git#worktree

Cursor CLI con Git Worktree

2 min read

Worktree te permite tener múltiples directorios (cada uno en una rama diferente) del mismo repo. Cursor CLI trabaja sobre el directorio donde se ejecuta. Combinados, puedes correr varios terminales con CLI Agents en paralelo sobre ramas distintas.

¿Por qué combinarlos?

Enfoque Cómo Ideal para
Worktree + múltiples ventanas de Cursor Abrir un worktree por ventana Usuarios de IDE que quieren árbol de archivos y preview
Worktree + CLI Múltiples terminales, cada uno con cd a un worktree y cursor agent Usuarios keyboard-first o entornos SSH

Punto común: cada worktree es un directorio independiente con su propio contexto, ideal para desarrollo paralelo.

Uso básico: un terminal por worktree

Suponiendo que ya creaste tus worktrees:

~/projects/
├── my-app/                  ← main
├── my-app--feature-auth/    ← feature/auth
└── my-app--feature-payment/  ← feature/payment

Terminal 1 (auth):

cd ~/projects/my-app--feature-auth
cursor agent "Implement JWT login"

Terminal 2 (payment):

cd ~/projects/my-app--feature-payment
cursor agent "Add Stripe checkout flow"

La CLI usa por defecto el directorio actual como contexto, así que cada terminal modifica solo su worktree.

Sin cambiar de directorio: usar --path

Si estás en el directorio principal pero quieres apuntar a un worktree específico:

cd ~/projects/my-app
cursor agent "Add unit tests for feature/auth" --path ../my-app--feature-auth

--path define explícitamente sobre qué directorio trabajar.

No interactivo + Worktree (scripts y lotes)

Ejecutar la misma tarea en varios worktrees:

cursor agent "Fix all auto-fixable errors per .eslintrc" --path ../my-app--feature-auth --no-interactive
cursor agent "Fix all auto-fixable errors per .eslintrc" --path ../my-app--feature-payment --no-interactive

O con loop:

for dir in ../my-app--feature-auth ../my-app--feature-payment; do
  cursor agent "Fix linter errors" --path "$dir" --no-interactive
done

Relación con "Worktree + múltiples ventanas"

  • Múltiples ventanas: una por worktree, usando Agent/Chat/Tab del IDE
  • CLI + Worktree: mismo concepto, interfaz de terminal

También puedes mezclar ambos enfoques.

Resumen

  • Worktree + CLI es una combinación natural para paralelizar
  • Para paralelo: varios terminales, cada uno en un worktree distinto
  • Para un solo terminal: --path <worktree-path>
  • Para lotes: --path + --no-interactive

Siguiente: 07-unlimit-loop-debug — Bucle automático hasta pasar tests.