Un gestor de worktrees de git
para Claude Code, Codex y cualquier CLI de agente

Un worktree de git es un segundo checkout del mismo repositorio, en su propia carpeta y en su propia rama, que comparte el historial y el remoto con tu checkout principal. Dar uno a cada agente de código IA significa que cada agente modifica, compila y hace commit de su propia copia de los archivos, así que dos agentes que trabajan a la vez nunca se sobrescriben ni cambian de rama bajo los pies del otro. Nuestro blog tiene una guía más larga sobre la parte de git: Git worktrees: la base para ejecutar varios agentes de IA sin conflictos.

Sí. claude --worktree <nombre> (o -w) crea .claude/worktrees/<nombre> en una rama llamada worktree-<nombre>, copia los archivos ignorados por git listados en .worktreeinclude y pregunta si conservar o eliminar el worktree al salir; los subagentes pueden ejecutarse en su propio worktree con isolation: worktree. No instala tus dependencias. En AgentsRoom puedes seguir usándolo, o dejar que el ticket o el agente pida el worktree, lo que además lo prepara y lo muestra en la pestaña Cambios (comprobado con Claude Code 2.1.299).

La app de Codex sí: crea worktrees gestionados en $CODEX_HOME/worktrees, en HEAD desacoplado, copia los archivos ignorados listados en .worktreeinclude, puede ejecutar los scripts de setup de un entorno local, conserva los 15 más recientes y mueve una conversación entre Local y un worktree con Handoff. codex-cli 0.162.1 tiene un flag --worktree que ejecuta una sesión en un nuevo worktree gestionado. AgentsRoom le da un worktree a un agente de Codex igual que a cualquier otro agente, desde el ticket o desde la ventana Añadir agente.

Todos: el worktree es simplemente el directorio de trabajo del agente, sea cual sea el CLI que se ejecute en él, así que Claude, Codex, GitHub Copilot CLI, Cursor y otros 10 CLI de agente trabajan en él de la misma forma. Kimi Code y Antigravity CLI confían en una carpeta por su ruta exacta; AgentsRoom registra un worktree nuevo como carpeta de confianza para ellos antes del lanzamiento, para que no se detengan en una pregunta de confianza.

No. Antes de que el primer agente arranque en un worktree nuevo, AgentsRoom copia los archivos ignorados por git del checkout principal que coinciden con Archivos copiados desde este checkout (todos los archivos .env por defecto) y ejecuta el comando de instalación detectado a partir del lockfile de la raíz. Las dos cosas se configuran en Configuración del proyecto > Git > Preparar los nuevos worktrees, donde puedes sustituir el comando, por ejemplo por pnpm install && pnpm build:deps. Un archivo que ya existe en el worktree nunca se sobrescribe.

Abre la pestaña Cambios y elige el worktree en el selector Worktree de arriba: la lista de archivos, los diffs, la revisión, Commit, Pull y Push actúan entonces sobre ese checkout. Para un ticket, Fusionar automáticamente en la rama actual al terminar la tarea fusiona su rama cuando lo marcas como Listo, y Hacer commit automáticamente al terminar el trabajo (Ajustes > Backlog) hace commit primero de lo que dejó el agente, para que la fusión incluya todo el trabajo.

Dentro del proyecto, bajo .worktrees/<branch>/, creados a partir de la rama por defecto del remoto salvo que definas una Rama base de los worktrees en la configuración del proyecto. La carpeta se añade al .git/info/exclude del clon, nunca a tu .gitignore, así que queda fuera de tus commits. Los worktrees nunca se eliminan automáticamente: elimina uno con git worktree remove cuando hayas terminado con él.

Sí, en los dos casos. En el móvil, la pantalla Cambios tiene el mismo selector Worktree, y un ticket que pide un worktree se ejecuta en él cuando lo inicias desde el móvil, preparado por la app de escritorio como cualquier otro. Un proyecto abierto en un servidor SSH tiene sus worktrees en el servidor, sin el paso de instalación. Un checkout local cuyos agentes se ejecutan en un host remoto no puede usar worktrees, y el ticket te lo indica en lugar de arrancar.