Un worktree de git es una copia separada de tu repositorio en su propia rama. Comparte el mismo historial de git que el repositorio principal, pero tiene sus propios archivos en otra carpeta. Puedes tener abiertos tantos como quieras a la vez.
el problema que resuelven los worktrees
Normalmente, tu repositorio es una carpeta con una rama activa. Si quieres trabajar en dos funciones a la vez, tienes que guardar los cambios aparte, cambiar de rama, hacer el otro trabajo, volver y recuperar los cambios. Es un fastidio.
Con los worktrees, tienes una segunda carpeta que ya está en otra rama. Trabaja en la función A en una carpeta y en la función B en otra. No tienes que guardar cambios aparte ni cambiar de rama. Ambas existen al mismo tiempo.
por qué importa para los agentes de ia
Si ejecutas dos agentes de IA en la misma carpeta, sobrescribirán los cambios del otro. El agente A edita auth.ts. El agente B también edita auth.ts. Gana quien guarde al final. El trabajo del otro agente desaparece.
Los worktrees lo arreglan. Cada agente tiene su propia carpeta, rama y copia de los archivos. Ambos pueden editar auth.ts a la vez sin molestarse. Cuando terminan, fusionas cada rama por separado.
cómo se ve en el disco
my-project/ ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)
Las tres carpetas comparten el mismo historial de git. Los cambios confirmados en un worktree aparecen en los demás cuando los fusionas. Pero los cambios sin confirmar están totalmente aislados.
cómo lo automatiza pane
No tienes que ejecutar comandos de git. Cuando creas un pane nuevo en Pane:
Pane crea el worktree y la rama por ti.
Copia tus variables de entorno, node_modules y otras carpetas importantes para que tu agente empiece de inmediato.
Cuando archivas el pane, Pane elimina el worktree automáticamente.
la forma manual, como referencia
Si quisieras hacerlo sin Pane:
git worktree add ../feature-a feature-a
cd ../feature-a
claude # start your agent here
# when done:
git worktree remove ../feature-a
Un worktree de git es una copia de trabajo separada de tu repositorio. Tiene su propia carpeta, rama y archivos, pero comparte el historial de git con tu repositorio principal. Puedes abrir varios a la vez, cada uno en una rama distinta.
Una rama solo apunta a un commit. En una carpeta solo puedes tener activa una rama. Un worktree te da una segunda, tercera o cuarta carpeta, cada una con su propia rama activa. Puedes editar archivos en todas a la vez.
Un clon copia todo el repositorio, incluido el historial de git. Un worktree comparte ese historial con el repositorio original. Casi no ocupa espacio adicional y se mantiene sincronizado automáticamente.
Si dos agentes trabajan en los mismos archivos y carpeta, sobrescribirán sus cambios. Los worktrees dan una copia aislada a cada agente. El agente A puede editar auth.ts en un worktree mientras el agente B edita auth.ts en otro, en ramas distintas y sin conflictos.
Sí. Cuando creas un pane nuevo con los worktrees activados, Pane ejecuta git worktree add, prepara la rama, copia tus variables de entorno y node_modules, y lo elimina todo cuando archivas el pane.
Sí. Desactiva 'Use Worktrees' en el cuadro New Pane. El agente se ejecutará en tu árbol de trabajo principal, no en una rama aislada. Sirve para tareas rápidas en las que el aislamiento no importa.
Sí. Cada worktree contiene el monorepo completo, así que los agentes pueden trabajar en paquetes distintos en paralelo. Limita cada agente a la carpeta de su paquete y no se molestarán.
Aviso de Windows SmartScreenLas descargas directas pueden mostrar un aviso de SmartScreen mientras Pane no esté firmado. Pane es totalmente de código abierto. Puedes revisar el código y compilarlo tú mismo.1. Haz clic en Más información2. Haz clic en Ejecutar de todas formas3. Continúa con la instalaciónLa instalación con PowerShell descarga la versión oficial directamente y evita la mayoría de los problemas del navegador.instalación global con npm
