Tutorial 15: Worktrees Git — Agenti in Parallelo

Questo fa parte della serie di tutorial ufficiali di Hermes Agent. Vedi tutti i tutorial

Immagina di avere una sola cucina ma due chef. Se cucinano entrambi sullo stesso piano di lavoro, si scontreranno coi gomiti, rovesceranno la farina e rovineranno i piatti dell’altro. I worktree di Git danno a ogni chef il suo piano di lavoro: stessa cucina, ma spazi di lavoro separati. È esattamente ciò che questa funzionalità fa per i tuoi agenti AI.

Perché Dovresti Interessartene? Il Problema con un Solo Checkout

Hermes Agent tratta la cartella in cui lo esegui come root del progetto. Se avvii due agenti nella stessa cartella, condividono ogni file. Questo significa che:

L’agente A potrebbe cancellare un file che l’agente B sta modificando.
Non puoi capire quali modifiche derivano da quale esperimento.
I rollback diventano un disastro: l’annullamento di un agente potrebbe cancellare il lavoro dell’altro.

I worktree risolvono tutto questo dando a ogni agente:

Il suo ramo (così le modifiche non si scontrano)
La sua cartella di lavoro (così i file non entrano in conflitto)
La sua cronologia di checkpoint (così /rollback influenza solo quell’agente)

Passo 1: Creare un Worktree (Il Comando Base)

Dalla tua repository principale (quella con .git/ dentro), esegui:

git worktree add ../my-agent-folder -b my-feature-branch

Analizziamolo:

../my-agent-folder – dove vivrà la nuova cartella (fuori dalla tua repo principale)
-b my-feature-branch – crea un nuovo ramo per questo agente

Ora hai una copia fresca e isolata del tuo progetto.

Passo 2: Puntare Hermes al Worktree

Puoi usare il worktree in due modi:

Opzione A: CLI (la più semplice)
Basta fare cd nel worktree ed eseguire Hermes lì:

cd ../my-agent-folder
hermes chat

Opzione B: Gateway di messaggistica (come Slack o Discord)
Se usi un gateway, modifica ~/.hermes/config.yaml e imposta terminal.cwd sul percorso del worktree:

terminal:
  cwd: /path/to/my-agent-folder

Ora ogni messaggio che quell’agente riceve verrà elaborato dentro quella cartella isolata.

Passo 3: Eseguire Più Agenti in Parallelo

Crea tutti i worktree che ti servono:

git worktree add ../agent-experiment-1 -b exp-1
git worktree add ../agent-experiment-2 -b exp-2

Poi avvia una sessione Hermes in ogni cartella. Non toccheranno mai i file degli altri, e ognuno ha il suo ramo su cui fare commit.

Passo 4: Pulire Quando Hai Finito

Quando un esperimento è concluso, rimuovi il worktree:

git worktree remove ../agent-experiment-1
git branch -d exp-1

Il primo comando elimina la cartella; il secondo elimina il ramo. La tua repo principale resta pulita.

Punti Chiave da Ricordare

I worktree sono leggeri – non copiano l’intera repo, solo i file che ti servono.
Ogni agente ha la sua cronologia /rollback – niente più disastri di annullamento incrociati tra agenti.
Usa i rami con intelligenza – nominali in modo chiaro (es. refactor-login, fix-bug-42) così sai cosa ha fatto ogni agente.

Riepilogo

I worktree di Git ti permettono di eseguire più agenti Hermes sullo stesso progetto senza che si pestino i piedi a vicenda. Crea un worktree per agente, punta Hermes lì, e il gioco è fatto. È come dare a ogni chef il suo tagliere: stessa cucina, zero collisioni.