← Volver al blog
Aiaprox. 7 min de lectura

Lanza diez agentes en paralelo y tu repositorio de Git se rompe primero

Publicado 7 nov 2026
Lanza diez agentes en paralelo y tu repositorio de Git se rompe primero

El discurso sobre los agentes de código ha sido el mismo todo el año: corren sin supervisión, así que deberías correr varios a la vez. Cinco, diez, más. Uno en el refactor de autenticación, uno en la prueba inestable, uno en la migración que nadie quiere tocar.

Las herramientas aguantan en general. Luego lo pruebas, y lo que se rompe resulta ser tu directorio de trabajo.

Dos agentes en un mismo checkout se sobrescriben los archivos entre sí en un minuto. La solución está en git desde 2015: los worktrees, que le dan a cada rama su propio directorio mientras comparten una sola base de objetos. Git puede hacer esto. La interfaz de git para hacerlo es lo bastante mala como para que casi nadie la use.

Worktrunk es un CLI en Rust que arregla la interfaz. Tiene 11.900 estrellas, unas 2.200 de la última semana, y es MIT o Apache-2.0 según cuál prefieras.

El problema de escribir tres veces

Crear un worktree en git exige escribir el nombre de la rama tres veces:

git worktree add -b feat ../repo.feat cd ../repo.feat

Dos de esos tres son redundantes. Existen porque el comando quiere una ruta y una rama, y la ruta casi siempre se puede derivar de la rama. Suena a una molestia menor. Es la razón por la que los worktrees siguieron siendo una técnica para gente con opiniones fuertes en vez de un valor por defecto.

Worktrunk direcciona los worktrees por nombre de rama y calcula la ruta a partir de una plantilla configurable. Cualquier comando que acepte una rama también acepta la ruta del worktree que la contiene. Así que el baile incómodo de tres líneas se vuelve:

wt switch -c -x claude feat

Crea una rama, crea su worktree y arranca Claude ahí, desde donde estés. El flag -x ejecuta un comando después de cambiar. Todo lo que agregues después de un separador se pasa a ese comando, y así le entregas al agente su primera instrucción:

wt switch -x claude -c feature-auth

Tres de esos en un solo shell y tienes tres agentes en tres ramas, aislados, sin coordinación entre ellos.

Instalación

Homebrew en macOS o Linux: brew install worktrunk && wt config shell install. Cargo, pacman, conda-forge y pixi funcionan todos. En Windows es winget install max-sixty.worktrunk seguido de git-wt config shell install.

La nota de Windows vale repetirla porque le va a pasar a alguien: wt ya apunta a Windows Terminal, así que Winget instala la herramienta como git-wt para evitar la colisión. También puedes desactivar el alias de Windows Terminal en los alias de ejecución de aplicaciones y usar wt directamente.

El paso config shell install no es opcional. Instala el hook de shell que permite que un comando cambie tu directorio actual, y ese es todo el mecanismo detrás de wt switch. Sáltalo y cada comando parece no hacer nada.

Los comandos que importan

Cuatro cubren la mayor parte del flujo de trabajo.

wt switch te mueve. wt list muestra cada worktree con marcadores de estado: @ para donde estás, + para cambios en stage, ↑1 para un commit por delante de main, ⇡ para commits sin subir. Solo esa salida es mejor que git worktree list, que te da rutas y nada más.

wt remove limpia, borrando el worktree y la rama juntos, lo que en git son dos comandos y un solo lugar donde equivocarse.

wt merge main es el interesante. Hace squash de la rama actual, la rebasea sobre main, hace fast-forward y elimina el worktree, en un solo paso. Si alguna vez resolviste el mismo conflicto tres veces en tres ramas paralelas, sabes por qué existe. El paralelismo multiplica el problema de merge, y el problema de merge ya era la parte menos agradable del trabajo.

También está wt switch pr:123, que salta directo a la rama detrás de un pull request. Función pequeña, calidad de vida desproporcionada.

El almacenamiento es la parte de la que nadie te advierte

Diez worktrees son diez copias de node_modules y diez copias de target/. En una laptop eso son cientos de gigabytes, y el primer cargo build en cada uno tarda cuatro minutos.

Worktrunk maneja esto con cachés de compilación copy-on-write. En sistemas de archivos que lo soportan, APFS en macOS, btrfs y XFS con reflinks en Linux, los worktrees comparten el directorio de compilación y solo divergen cuando cambia un archivo. La primera compilación paga. Las siguientes nueve piden prestado.

Es el tipo de función que revela para qué usa el autor la herramienta en realidad. Nadie agrega cachés de compilación compartidos a un gestor de worktrees por marketing. Los agrega después de la cuarta vez que se le llenó el disco.

El detalle relacionado es hash_port, un filtro de plantilla que le da a cada worktree un puerto único. Diez worktrees, diez servidores de desarrollo, sin colisiones de puerto, sin llevar cuentas a mano. Combínalo con un hook post-start que instala dependencias y levanta el servidor, y un worktree nuevo queda completamente operativo en el momento en que arranca el agente.

Los hooks son el lado filoso

Los hooks ejecutan comandos de shell automáticamente en momentos definidos: después de que arranca un worktree, antes de un merge, después de un merge. Los hooks post-start son la forma de obtener la configuración del entorno gratis.

También son ejecución de código arbitrario disparada por una operación de git. Un repositorio puede traer una configuración que ejecute algo en wt switch, y si lo clonas y cambias a una rama, lo ejecutaste. Es la misma clase de riesgo que npm install corriendo un script postinstall, y merece el mismo trato: lee la configuración antes de confiar en el repo.

La respuesta de la herramienta a esto es que los hooks se declaran en configuración que tú controlas. Si eso alcanza depende de tu modelo de amenaza, y para cualquiera que clone repositorios desconocidos vale pensarlo.

Lo que no arregla

Los worktrees comparten un solo directorio .git, lo que significa que comparten referencias de ramas, stash y configuración. Dos agentes no pueden hacer checkout de la misma rama. Un git rebase en un worktree cambia historia sobre la que está sentado otro worktree. Las entradas de reflog se entrelazan de formas que hacen más difícil el trabajo forense.

Worktrunk hace agradable el caso común y no cambia el modelo de fondo. Si tus agentes necesitan repositorios genuinamente independientes, quieres clones separados, y pierdes el almacén de objetos compartido que hace baratos a los worktrees en primer lugar.

También hay un problema de coordinación que la herramienta no toca. Diez agentes en diez ramas producirán diez pull requests que tocan los mismos tres archivos, y ninguna cantidad de gestión de worktrees hace que se fusionen limpiamente. Los equipos que obtienen valor del paralelismo parecen ser los que asignan áreas disjuntas, no los que corren más agentes.

Por qué este tipo de herramienta está ganando atención

Los frameworks de agentes se llevan los anuncios. Las utilidades que hacen usables a los agentes se llevan las estrellas.

Ese patrón se repitió todo el año: capas de memoria, modos de permisos, sandboxes, gestores de worktrees. Cada uno existe porque el modelo se volvió lo bastante bueno para hacer el trabajo y el entorno nunca fue diseñado para un trabajador que no se cansa, no hace preguntas y correrá felizmente cuarenta minutos en el directorio equivocado.

Worktrunk es una respuesta pequeña y enfocada a uno de esos huecos. Sus 11.900 estrellas cuentan a los desarrolladores que intentaron correr tres agentes a la vez y descubrieron que la parte difícil era el sistema de archivos.

Artículos relacionados