Un worktree de Git es una copia de trabajo separada del repositorio que permite que varios agentes trabajen en carpetas distintas. Así evitan pisarse los archivos de una misma carpeta, pero sus ramas todavía tienen que integrarse y revisarse.

Qué aíslan los worktrees y qué ocurre al integrar ramas

Cada agente trabaja en su propia copia, así que los cambios sin guardar en una carpeta no se mezclan con los de otra. El aislamiento termina ahí: dos ramas pueden modificar el mismo archivo o las mismas líneas, y Git tendrá que combinar los cambios cuando se integren.

Si las modificaciones afectan a líneas distintas, Git puede combinarlas automáticamente. Cuando se solapan, puede señalar un conflicto que requiere resolución. Y que la fusión termine sin errores de texto no garantiza que el programa funcione: una llamada puede seguir apuntando a una función que otra rama renombró. El manual de Git sobre conflictos de fusión recomienda revisar el resultado y comprobar el código.

Usa worktrees para separar el trabajo de edición; reserva tiempo para revisar y probar el resultado integrado.

Worktrees de Cursor: Agents Window, IDE y configuración

Cursor ofrece los worktrees nativos en Agents Window. En el IDE, su documentación describe comandos de Worktree Skills, entre ellos /worktree, /best-of-n, /apply-worktree y /delete-worktree (documentación de Cursor sobre worktrees).

/best-of-n ejecuta candidatos en worktrees separados para compararlos; no fusiona sus cambios automáticamente. Eliges un resultado y lo aplicas por separado. Esto sirve para comparar alternativas sin reunir de golpe todos los cambios de varias ejecuciones.

Para preparar un worktree, Cursor admite el archivo .cursor/worktrees.json. Puede incluir instrucciones específicas para Unix o Windows, o una configuración genérica; los comandos se ejecutan en secuencia y también se puede indicar la ruta a un script. Cursor busca el archivo primero en la carpeta del worktree y después en la raíz del proyecto.

Cursor también puede limpiar worktrees manuales

Los worktrees creados con git worktree add pueden entrar en la limpieza automática de Cursor, igual que los creados desde la aplicación. Para Cursor 3.5 y versiones posteriores, la documentación fija en 25 worktrees por máquina el límite predeterminado, sumando los distintos espacios de trabajo. Las seis horas aparecen como intervalo en un ejemplo de configuración, no como una frecuencia universal.

Por eso, crear un worktree manualmente no lo deja fuera del alcance de la limpieza de Cursor. Ten presente ese límite al organizar copias de trabajo que quieras conservar.

Si cambiar de worktree interrumpe una tarea

En una respuesta del 10 de septiembre de 2026, personal de Cursor atribuyó una interrupción reportada a que el agente creaba un worktree y cambiaba allí su carpeta de trabajo a mitad de la tarea. Como solución para ese caso, recomendó iniciar el agente directamente en la carpeta donde debía trabajar; también indicó que escribir «continue» reanuda una tarea detenida (respuesta del equipo de Cursor).