Git worktrees: la base para ejecutar varios agentes de IA sin conflictos

Lanzas dos agentes sobre el mismo repo. Uno edita package.json, el otro también. Treinta segundos después tu código está en un estado que nadie puede fusionar.

Eso no es un fallo de tus agentes. Es que todos trabajan en la misma carpeta.

La solución es una herramienta que Git tiene desde hace años y que casi nadie usa: git worktree.

El problema: 3 agentes, 1 repo, fusión imposible

Un repo de Git normal es una carpeta con una rama activa cada vez. Trabajas en main, cambias de rama y toda la carpeta cambia con ella.

Ahora mete tres agentes autónomos en esa carpeta. Escriben a la vez. El agente A crea un archivo, el agente B ejecuta git checkout para empezar limpio y borra el trabajo en curso de A. Acabas con archivos a medio escribir, un índice destrozado y conflictos que cuesta más desenredar que si lo hubieras programado tú mismo.

El paralelismo solo te ahorra tiempo si los agentes no se tocan entre sí.

Qué es un git worktree

Un worktree es una segunda carpeta de trabajo asociada al mismo repo.

Mismo historial, mismo remoto, pero cada worktree tiene su propia rama activa y sus propios archivos en disco. Puedes tener cinco lado a lado, cada uno en una rama distinta, sin que se estorben.

Un solo .git, varios espacios de trabajo. Eso es todo.

Un worktree por agente, en la práctica

Aquí tienes el montaje. Desde tu repo:

git worktree add ../project-auth -b feature/auth
git worktree add ../project-billing -b feature/billing
git worktree add ../project-export -b feature/export

Acabas de crear tres carpetas, cada una en su propia rama. Arrancas un agente en cada una:

cd ../project-auth && claude
cd ../project-billing && codex

Cada agente tiene su carpeta, su rama, sus archivos. El agente de auth nunca verá lo que hace el de billing. Ninguna colisión posible.

Cuando una funcionalidad está lista, revisas su rama y la fusionas. Luego limpias:

git worktree remove ../project-auth

La carpeta desaparece, la rama se queda en tu historial. Limpio.

Las 3 trampas que conviene conocer

Primera trampa, el archivo central compartido. Si dos funcionalidades tienen que tocar las dos el mismo routes.ts o el mismo esquema de base de datos, los worktrees no te salvan: tendrás el conflicto a la hora de fusionar. Un agente toca los archivos que comparten todos, los demás esperan o buscan otra forma.

Segunda, las ramas que se desvían. Mientras tus agentes trabajan, main sigue avanzando. Tres días después tus ramas están atrasadas y fusionar se vuelve doloroso. Haz rebase pronto y a menudo, o mantén las sesiones cortas.

Tercera, la limpieza olvidada. Cada worktree es una carpeta real en tu disco. Diez al día sin limpiar y tu carpeta padre se vuelve ilegible. git worktree list te muestra lo que anda por ahí, git worktree prune elimina los que ya no sirven.

La verdadera pregunta: ¿quién vigila las cinco carpetas?

Los worktrees resuelven las colisiones de archivos. No resuelven tu carga mental.

Tienes cinco carpetas, cinco agentes, cinco terminales. ¿Cuál está esperando tu revisión? ¿Cuál terminó hace diez minutos mientras mirabas a otro lado? ¿Cuál se ha caído?

Ahí es donde un worktree por agente choca con su límite si te quedas en la terminal. Has resuelto el conflicto técnico, pero has multiplicado las ventanas que vigilar.

AgentsRoom pone cada agente en un mosaico, con su estado y su color, sin importar en qué worktree se ejecute. Un agente que está esperando se pone en rojo y te avisa. Lee cómo ejecutar de 3 a 8 agentes en paralelo sin perder el hilo para el método completo que va por encima de los worktrees.

Qué quedarte de todo esto

Un agente, un worktree, una rama. Esa es la regla básica del trabajo multiagente serio.

Los comandos caben en tres líneas y el beneficio es inmediato: tus agentes dejan de pisarse entre sí. Añade una vista que te diga cuál te necesita y podrás llevar de verdad cinco tareas en paralelo sin perder la cabeza.