Worktrees
Trabaja en otra rama y carpeta de Git sin mover tu copia principal.
Un worktree es otra carpeta de trabajo del mismo repositorio Git, normalmente en una rama distinta. Sirve para separar una tarea de los archivos de la copia principal.
Crea un worktree gestionado
Ejecuta Clarvis desde cualquier copia de trabajo del repositorio:
clarvis --worktree docs-guideClarvis crea la rama clarvis/docs-guide en una copia gestionada bajo la copia principal del repositorio, o vuelve a abrir la que Git ya tenga registrada para esa rama. Pasa solo el nombre: Clarvis añade el prefijo clarvis/.
Omite el nombre para que Clarvis genere uno:
clarvis --worktreeLos nombres deben tener entre 1 y 80 caracteres ASCII, empezar por letra o número y contener solo letras, números, puntos, guiones bajos y guiones. También deben ser segmentos válidos de rama Git: se rechazan .., @{, un punto final y el sufijo .lock. El worktree se selecciona antes de iniciar la sesión, el kernel o la TUI, por lo que todas las operaciones usan la misma copia.
Continúa en la misma copia
Usa el mismo nombre en los siguientes inicios:
clarvis --worktree docs-guide --continueClarvis consulta la lista de worktrees registrada por Git; no mantiene un registro paralelo. Si se eliminó la copia gestionada pero queda la rama, el mismo comando puede recrearla. Si Git ya registra la rama en un worktree externo, Clarvis abre esa ruta sin moverla.
No se puede cambiar de worktree dentro de una sesión. Sal y vuelve a iniciar Clarvis con el nombre de destino para que todos los servicios utilicen el mismo espacio de trabajo.
Conserva o elimina la copia al salir
Si el worktree está limpio, la salida habitual con dos pulsaciones de Ctrl+C pregunta si quieres eliminar su copia:
- N conserva la copia y sale.
- Y elimina la copia limpia y sale.
- Escape cancela la salida.
Si hay cambios pendientes, Clarvis conserva la copia y no ofrece eliminarla. La eliminación nunca fuerza una operación de Git y la rama clarvis/<name> se conserva en ambos casos.
Atención
Una copia limpia solo significa que sus archivos no tienen cambios pendientes. No significa que la rama esté fusionada, publicada o sea seguro borrarla. Integra o elimina la rama con tu flujo habitual de Git.
Dónde se guardan las copias gestionadas
Clarvis las guarda en:
<primary-checkout>/.clarvis/worktrees/<name>Antes de crear una, comprueba que .clarvis/.gitignore de la copia principal excluya worktrees/, para evitar añadir por accidente archivos de la copia anidada al índice de Git. Los worktrees externos que crees por tu cuenta quedan fuera de esta limpieza gestionada.