Il caos dei repository multipli: come risolverlo

Se sei uno sviluppatore nel 2024, il tuo Mac o PC è pieno di cloni Git sparsi ovunque. Progetti aziendali, lavoretti personali, fork sperimentali, repo di clienti: un disordine totale sul disco. Quante volte hai cercato find ~ -name "quel-repo-lì" nel cuore della notte?

La situazione peggiora con gli agenti AI per il codice. Tool come Claude Code o GitHub Copilot velocizzano tutto, ma creano un problema: l'isolamento. Se usi più agenti in parallelo – uno che rifà l'infrastruttura, un altro che scrive endpoint API – serve uno spazio dedicato per ciascuno. Una cartella condivisa diventa un incubo.

Cambiare branch? Un calvario. Stash, checkout, conflitti, file persi per sbaglio: ostacoli che frenano te e gli AI.

La soluzione in tre tool: ghq + gwq + fzf

Per fortuna, la community open-source ha la cura. Tre tool combinati creano un ambiente ordinato, scalabile e ideale per flussi con AI.

Git worktree: sviluppo parallelo senza stress

Prima i fondamenti: git worktree. Questa funzione Git ti permette di avere più directory di lavoro per lo stesso repository. Niente più switch di branch o stash: ogni worktree ha il suo branch dedicato.

Per gli agenti AI è oro. Isolamento totale.

• Agente su feature A lavora in worktree A
• Agente su bug B in worktree B
• Zero interferenze
• Tutto procede in parallelo

Perfetto per l'AI moderna. Dai prompt a Claude per analizzare codice in un worktree, testa in un altro, e tieni il main pulito – tutto insieme.

Tool 1: ghq – Ordine nei cloni

ghq (GitHub Query) risolve il caos con una struttura fissa. Clona i repo in cartelle prevedibili basate sull'URL remoto.

Niente più cloni a casaccio. Ecco come organizza:

~/ghq/
  github.com/
    proprietario/
      nome-repo/
  gitlab.com/
    team/
      progetto/
  bitbucket.org/
    utente/
      codice/

Scegli la root (di solito ~/ghq). Da lì, tutto è standardizzato. Regola semplice: standardizza e automatizza.

Tool 2: gwq – Worktree da professionisti

gwq (git Worktree Query) porta la logica di ghq sui worktree. Li piazza accanto ai cloni, nella stessa root.

Configurazione minima in ~/.config/gwq/config.toml:

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

[worktree]
basedir = '~/ghq'

I worktree si distinguono subito. Esempio pratico:

~/ghq/
  github.com/acme/api                        # repo originale
  github.com/acme/api=feature-pagamenti      # worktree pagamenti
  github.com/acme/api=bugfix-autenticazione  # worktree auth
  github.com/acme/frontend                   # altro repo
  github.com/acme/frontend=ridisegno-ui      # worktree UI

Il suffisso =nome-branch chiarisce tutto. Ideale per task multipli, umani o AI.

Tool 3: fzf – Ricerca fuzzy magica

fzf (fuzzy finder) lega il tutto. È un'interfaccia terminale velocissima che filtra liste in tempo reale.

Prova: ghq list | fzf. Digita "api" e filtra istantaneamente. Invio, e sei dentro con cd.

Con la struttura fissa, è potentissimo. Basta ricordare percorsi: usa parole chiave, fzf pensa al resto.

Scorciatoie per navigare

Con i tre tool, crea funzioni shell facili.

Per saltare in un repo (clone o worktree):

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

Per worktree nel repo corrente:

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

Addio sprechi di tempo nei cambi di contesto.

Perché conta per lo sviluppo con AI

Il vero vantaggio? Orchestrare agenti AI e il tuo lavoro. Piattaforme come NameOcean's Vibe Hosting usano AI per deploy rapidi. Una struttura disco prevedibile non è un optional: è vitale.

Gli agenti guadagnano:

• Accesso veloce al codice
• Riferimenti file sicuri
• Separazione task paralleli
• Script auto affidabili

Come partire

Setup in 15 minuti:

1. Installa: ghq, gwq, fzf dai package manager
2. Configura ghq: ghq.root = ~/ghq nel Git config
3. Configura gwq: file ~/.config/gwq/config.toml con template e basedir
4. Aggiungi funzioni: metti le scorciatoie in .bashrc o .zshrc
5. Clona con ghq: usa ghq get, non git clone

In poche ore, non tornerai indietro. In settimane, è il tuo standard.

Il quadro generale

Questo stack segna un cambio epocale nella produttività dev. Non lotti contro il filesystem: lo domi. Non resisti al parallelo: lo abbracci, per umani e AI.

Quei 10-15% di tempo persi in frizioni? Si accumulano. Ogni switch evitato è una vittoria. Ogni conflitto saltato è slancio. Ogni agente AI isolato moltiplica l'output.

Se curi l'esperienza dev – tua o del team – padroneggia questo.