El desorden de repositorios múltiples

Si eres desarrollador en 2024, tu máquina local parece un cementerio de clones de Git. Proyectos laborales, experimentos personales, forks raros y repos de clientes. Todo desperdigado por el disco, medio olvidados. Seguro has buscado con find a las tantas de la madrugada.

El lío crece con los agentes de IA para código. Herramientas como Claude Code o GitHub Copilot aceleran todo, pero traen un problema: aislamiento. Si usas varios a la vez —uno refactorizando infra, otro armando endpoints—, necesitan espacios separados. Un directorio compartido pasa de ayuda a estorbo.

Cambiar branches se vuelve un suplicio. Guardar cambios, resolver conflictos, recuperar archivos borrados por error. Ya no son molestias menores. Son frenos para humanos y IA por igual.

La solución con tres herramientas: ghq + gwq + fzf

Hay buenas noticias. La comunidad open-source lo resolvió. Une estas tres herramientas y tendrás un entorno ordenado, escalable y listo para flujos con IA.

Git worktree: desarrollo paralelo sin dramas

Primero, el fondo técnico: git worktree. Esta función de Git te permite tener varios directorios de trabajo para un mismo repo al mismo tiempo. Olvídate de switches de branch y stashes. Cada worktree tiene su branch propio.

¿Para qué sirve con IA? Aislamiento total.

• Agente en feature A va a worktree A.
• Otro en bug B, a worktree B.
• No se pisan nunca.
• Avanzan en paralelo, sin interferencias.

Encaja perfecto con desarrollo moderno. Pide a Claude que revise código en un worktree, prueba en otro y deja el main limpio. Todo a un tiempo.

Herramienta 1: ghq — ordena el caos de repos

ghq (GitHub Query) es simple pero potente. Estandariza dónde clonas repos, basado en su URL remota.

Adiós a clones tirados por ahí. Usa esta estructura fija:

~/ghq/
  github.com/
    dueño/
      repo
  gitlab.com/
    equipo/
      proyecto
  bitbucket.org/
    usuario/
      codigo/

Tú eliges la raíz (suele ser ~/ghq). Todo queda predecible y fácil de encontrar. La idea clave: estandariza para automatizar después.

Herramienta 2: gwq — worktrees como un jefe

gwq (git Worktree Query) lleva la lógica de ghq a los worktrees. Los pone al lado de los clones originales, en la misma raíz.

Configuración dead simple en ~/.config/gwq/config.toml:

[naming]
template = '{{.Host}}/{{.Owner}}/{{.Repository}}={{.Branch}}'

[worktree]
basedir = '~/ghq'

Así, los worktrees se distinguen clarito. Mira este ejemplo:

~/ghq/
  github.com/acme/api                        # repo original
  github.com/acme/api=pagos                  # worktree para pagos
  github.com/acme/api=bug-auth               # worktree para bug auth
  github.com/acme/frontend                   # otro repo
  github.com/acme/frontend=rediseño-ui       # worktree para UI

El sufijo =branch lo deja todo obvio. Ideal para manejar hilos paralelos, sea con humanos o IA.

Herramienta 3: fzf — listas que se buscan solas

fzf (fuzzy finder) une todo. Es una interfaz terminal rápida que convierte listas en búsquedas interactivas.

El truco: pilla ghq list y lo filtras:

ghq list | fzf

No más cd manuales. Escribe "api" y filtra al vuelo. Enter y estás dentro.

Con la estructura fija, es un superpoder. Olvídate de paths exactos. Usa palabras clave; fzf hace el resto.

Atajos para navegar como rayo

Con las tres, arma funciones en shell que lo hacen fácil.

Para saltar a cualquier repo (original o worktree):

j() {
  cd "$(ghq list --full-path | fzf)"
}

Para worktrees del repo actual:

jw() {
  cd "$(git worktree list | awk '{print $1}' | fzf)"
}

Snippets básicos que acaban con el cambio de contexto eterno.

Por qué brilla con desarrollo asistido por IA

El valor real sale al coordinar varios agentes IA más tu propio código. Plataformas como NameOcean's Vibe Hosting usan IA para lanzar features rápido. Una estructura de archivos predecible no es lujo: es necesidad.

Los agentes ganan con paths consistentes:

• Llegan al código relevante en segundos.
• Referencian archivos sin dudas.
• Separan tareas paralelas.
• Crean scripts que no fallan por paths raros.

Cómo arrancar

En 15 minutos lo tienes:

1. Instala: ghq, gwq y fzf via gestores de paquetes.
2. Configura ghq: ghq.root = ~/ghq en tu Git config.
3. Configura gwq: Crea ~/.config/gwq/config.toml con template y basedir.
4. Atajos en shell: Pega las funciones en .bashrc o .zshrc.
5. Clona ya: Usa ghq get en vez de git clone.

En horas, no sabrás cómo vivías sin esto. En semanas, lo ves como base de todo desarrollo moderno.

La visión grande

Este stack marca un cambio en productividad dev. No peleamos con el filesystem: lo alineamos. No resistimos el paralelo: lo abrazamos. Para humanos e IA.

Esos roces que comían 10-15% de tu tiempo no van a cero de golpe. Pero se acumulan. Cada switch evitado es una victoria. Cada conflicto esquivado, momentum. Cada agente IA en su worktree aislado multiplica tu output.

Si vas en serio con la experiencia dev —tuya o de equipo—, domina este stack.