Un gestore di worktree git
per Claude Code, Codex e ogni CLI di agenti
Spunta una casella su un ticket, o scegli un worktree quando aggiungi un agente, e lavorerà nel proprio checkout, sul proprio branch. Più agenti modificano lo stesso repository nello stesso momento senza toccare i file degli altri.
Prima che l'agente parta, AgentsRoom installa le dipendenze e copia i tuoi file .env nel nuovo worktree, così può fare la build e lanciare i test da subito. Quando ha finito, rivedi, fai il commit, il push e il merge di quel worktree dalla scheda Modifiche, sul desktop o dal telefono.
- Agente backend.worktrees/fix-login-redirectPreparato
- Agente frontend.worktrees/settings-dark-modeAl lavoro
- Agente QA.worktrees/agents/qaRevisione
Tre agenti, tre worktree, un solo repository: ogni checkout viene preparato prima che parta il suo agente, poi rivisto e unito per conto suo.
Due agenti nello stesso checkout sono due persone che scrivono nello stesso file. Uno lancia il formatter mentre l'altro è a metà di una modifica, uno cambia branch sotto i piedi dell'altro, e il diff che rivedi alla fine mescola i due lavori. Un worktree git risolve il problema: un secondo checkout dello stesso repository, nella propria cartella e sul proprio branch, che condivide la cronologia ma non i file.
Crearne uno richiede un solo comando git. Conviverci con dieci è la parte difficile: un worktree appena creato non ha né node_modules né .env, quindi la prima build dell'agente fallisce; niente ti dice quale agente lavora dove; e quando il lavoro è finito devi ancora trovare la cartella, rivederla, fare il commit e il merge.
AgentsRoom gestisce questo ciclo di vita. Un ticket del backlog o un agente chiede un worktree, AgentsRoom lo crea da un branch di base aggiornato dentro il progetto, sotto .worktrees/, lo prepara, ci avvia l'agente e ti dà un selettore nella scheda Modifiche per rivederlo, fare il commit, il push e il merge. Funziona allo stesso modo qualunque sia la CLI che esegue l'agente: Claude, Codex, GitHub Copilot CLI, Cursor e altre 10 CLI di agenti.
I worktree restano facoltativi. Un agente senza worktree continua a lavorare nella cartella del progetto come prima, e decidi tu per ticket, per agente o per modello di agente.
Cosa fa il gestore di worktree
Dal momento in cui un'attività chiede un checkout isolato al momento in cui il suo branch viene unito.
Un worktree per ticket del backlog
Spunta Scrivi codice in un worktree separato per questa attività su un ticket, scegli uno dei worktree del progetto o scrivi il nome di un nuovo branch, e l'avvio del ticket crea il worktree e ci lancia dentro l'agente.
Scegli un worktree quando aggiungi un agente
Il riquadro Spazio di lavoro della finestra Aggiungi agente mostra Principale, i worktree esistenti del progetto e Nuovo. Compare anche un worktree che hai creato tu con git worktree add.
Un nuovo worktree per ogni agente di un modello
Attiva Un nuovo worktree per agente su un agente salvato o su un profilo predefinito, e ogni agente creato da lì riceve il proprio branch, chiamato agents/<modello> poi -2, -3, così le copie non condividono mai un checkout.
Pronto per la build dal primo avvio
Prima che il primo agente parta in un nuovo worktree, AgentsRoom copia i file ignorati da git di cui ha bisogno (tutti i file .env per impostazione predefinita) ed esegue il comando di installazione rilevato dal tuo lockfile: yarn, pnpm, npm, bun, uv, poetry, pipenv, bundle o composer.
Rivedi, fai il commit e il push di ogni worktree
Il selettore Worktree in cima alla scheda Modifiche sposta il diff, la revisione, Esegui commit, Pull e Push su quel checkout. Un clic sul badge di un agente che ha il proprio worktree lo apre direttamente.
Unito quando il ticket è completato
Con Unisci automaticamente nel branch corrente al completamento dell'attività, segnare il ticket come Completato fa il merge del suo branch. Attiva Esegui il commit automaticamente a lavoro finito perché anche ciò che l'agente ha lasciato senza commit entri nel merge.

Come funziona
Il percorso di un ticket, dal modulo al merge.
- 1
Chiedi un worktree sul ticket
Nel modulo del ticket, sotto Esecuzione, spunta Scrivi codice in un worktree separato per questa attività. Scegli un worktree esistente tra i chip, o tieni il campo Nome del branch: viene precompilato dal titolo finché non lo modifichi, e diventa un nuovo worktree quando l'attività parte.
- 2
Avvia il ticket
AgentsRoom fa il fetch del branch di base (il branch predefinito del remote, o il Branch di base dei worktree impostato nelle impostazioni del progetto), crea il worktree sotto .worktrees/<branch>/ e aggiunge quella cartella al .git/info/exclude del clone, così non compare mai come file non tracciati nel tuo checkout principale.
- 3
Il worktree viene preparato, poi l'agente parte
Il terminale dell'agente mostra il comando di installazione e il suo output, una notifica dice quanti file ignorati sono stati copiati, poi la CLI dell'agente parte nel worktree. Succede una sola volta per worktree; un'installazione fallita non blocca mai l'agente, l'errore resta nel suo terminale.
- 4
Rivedi e fai il merge
Scegli il worktree nella scheda Modifiche per leggere il diff e fare il commit. Segna il ticket come Completato e, con il merge automatico attivo, il suo branch viene unito nel branch corrente; la conferma mostra il risultato. Il worktree resta sul disco per un'ultima occhiata.

Claude Code e Codex creano già worktree. Ecco la differenza.
Claude Code ha un suo flag: claude --worktree feature-auth crea .claude/worktrees/feature-auth su un branch chiamato worktree-feature-auth, copia i file ignorati da git elencati in un file .worktreeinclude e chiede se tenere o rimuovere il worktree quando esci. La sua documentazione dice chiaramente che un worktree è un checkout nuovo e che le dipendenze le installi tu, o le fai installare a Claude. Anche i subagenti possono ricevere un worktree ciascuno con isolation: worktree.
L'app Codex gestisce i worktree in $CODEX_HOME/worktrees, li avvia in detached HEAD dal branch che hai scelto, legge anche lei .worktreeinclude, esegue gli script di setup di un ambiente locale se ne scegli uno, e tiene i 15 più recenti per impostazione predefinita. Handoff sposta una conversazione e il suo codice tra Local e un worktree. Anche codex-cli 0.162.1 ha un flag --worktree.
Sono fatti bene entrambi, e ognuno appartiene a un solo fornitore. AgentsRoom non li sostituisce: porta lo stesso isolamento un livello più su, dove vivono i tuoi ticket e i tuoi agenti, per tutte le CLI insieme, prepara il checkout prima che l'agente lo veda e tiene la revisione, il commit e il merge nella finestra che usi già. Verificato su Claude Code 2.1.299 e codex-cli 0.162.1, a ottobre 2026.
Cosa sapere
- Un worktree non viene mai eliminato automaticamente, di proposito, così puoi rivederlo. Si accumulano sotto .worktrees/; rimuovine uno con git worktree remove quando hai finito, mai mentre un agente sta ancora girando al suo interno.
- Un merge automatico che incontra un conflitto registra un avviso e il ticket passa comunque a Completato: quel merge va risolto a mano.
- I worktree richiedono un repository git alla radice del progetto. Una cartella che si limita a raggruppare più repository uno accanto all'altro non ne ha: apri ogni repository come un progetto a sé.
- Un progetto aperto su un server SSH ha i suoi worktree sul server, senza la fase di installazione. Un checkout locale i cui agenti girano su un host remoto non può usare i worktree, e il ticket lo segnala invece di partire.
- Un agente QA non ha mai il proprio worktree: testa dentro il checkout del suo agente master, perché un worktree nuovo non conterrebbe il lavoro non committato che deve testare.
Domande frequenti
Cos'è un worktree git, e perché darne uno a un agente IA?
Un worktree git è un secondo checkout dello stesso repository, nella propria cartella e sul proprio branch, che condivide la cronologia e il remote con il tuo checkout principale. Darne uno a ogni agente IA di coding significa che ogni agente modifica, compila e committa la propria copia dei file, così due agenti che lavorano nello stesso momento non si sovrascrivono mai e non cambiano mai branch sotto i piedi l'uno dell'altro. Il nostro blog ha una guida più lunga sulla parte git: Git worktree: le fondamenta per far girare più agenti AI senza conflitti.
Claude Code ha i worktree integrati?
Sì. claude --worktree <nome> (o -w) crea .claude/worktrees/<nome> su un branch chiamato worktree-<nome>, copia i file ignorati da git elencati in .worktreeinclude e chiede se tenere o rimuovere il worktree quando esci; i subagenti possono girare nel proprio worktree con isolation: worktree. Non installa le tue dipendenze. In AgentsRoom puoi continuare a usarlo, oppure lasciare che sia il ticket o l'agente a chiedere il worktree, che così viene anche preparato e mostrato nella scheda Modifiche (verificato su Claude Code 2.1.299).
Codex supporta i worktree?
L'app Codex sì: crea worktree gestiti in $CODEX_HOME/worktrees, in detached HEAD, copia i file ignorati elencati in .worktreeinclude, può eseguire gli script di setup di un ambiente locale, tiene i 15 più recenti e sposta una conversazione tra Local e un worktree con Handoff. codex-cli 0.162.1 ha un flag --worktree che avvia una sessione in un nuovo worktree gestito. AgentsRoom dà un worktree a un agente Codex nello stesso modo che a qualsiasi altro agente, dal ticket o dalla finestra Aggiungi agente.
Quali CLI di agenti possono girare in un worktree di AgentsRoom?
Tutte: il worktree è semplicemente la cartella di lavoro dell'agente, qualunque sia la CLI che ci gira, quindi Claude, Codex, GitHub Copilot CLI, Cursor e altre 10 CLI di agenti ci lavorano allo stesso modo. Kimi Code e Antigravity CLI si fidano di una cartella in base al suo percorso esatto; AgentsRoom registra un nuovo worktree come attendibile per loro prima dell'avvio, così non si fermano su una domanda di fiducia.
Devo lanciare yarn install e copiare il mio .env in ogni worktree?
No. Prima che il primo agente parta in un nuovo worktree, AgentsRoom copia i file ignorati da git del checkout principale che corrispondono a File copiati da questo checkout (tutti i file .env per impostazione predefinita) ed esegue il comando di installazione rilevato dal lockfile alla radice. Entrambi si impostano in Impostazioni del progetto > Git > Prepara i nuovi worktree, dove puoi sostituire il comando, per esempio con pnpm install && pnpm build:deps. Un file già presente nel worktree non viene mai sovrascritto.
Come rivedo e faccio il merge di ciò che un agente ha fatto nel suo worktree?
Apri la scheda Modifiche e scegli il worktree nel selettore Worktree in alto: l'elenco dei file, i diff, la revisione, Esegui commit, Pull e Push agiscono allora su quel checkout. Per un ticket, Unisci automaticamente nel branch corrente al completamento dell'attività fa il merge del suo branch quando lo segni come Completato, e Esegui il commit automaticamente a lavoro finito (Impostazioni > Backlog) committa prima ciò che l'agente ha lasciato, così il merge porta con sé tutto il lavoro.
Dove sono i worktree, e vengono ripuliti?
Dentro il progetto, sotto .worktrees/<branch>/, creati dal branch predefinito del remote a meno che tu non imposti un Branch di base dei worktree nelle impostazioni del progetto. La cartella viene aggiunta al .git/info/exclude del clone, mai al tuo .gitignore, quindi resta fuori dai tuoi commit. I worktree non vengono mai eliminati automaticamente: rimuovine uno con git worktree remove quando non ti serve più.
Posso usare i worktree dal telefono o su un server remoto?
Sì, in entrambi i casi. Sul telefono, la schermata Modifiche ha lo stesso selettore Worktree, e un ticket che chiede un worktree gira al suo interno quando lo avvii dal telefono, preparato dall'app desktop come qualsiasi altro. Un progetto aperto su un server SSH ha i suoi worktree sul server, senza la fase di installazione. Un checkout locale i cui agenti girano su un host remoto non può usare i worktree, e il ticket te lo segnala invece di partire.
Approfondimenti
Git worktree: le fondamenta per far girare più agenti AI senza conflitti
I tuoi agenti si sovrascrivono a vicenda quando girano in parallelo. I git worktree risolvono tutto in due comandi. Ecco come usarli.
Dieci agenti hanno lanciato lo stesso typecheck insieme. La soluzione era una cartella.
Diciassette agenti di codice nello stesso checkout, dieci processi tsc insieme, load average 37 e 87 MB di RAM libera. Un typecheck da novanta secondi ci ha messo 7 min 36. Ecco la misura, perché la macchina non calcolava, e il piccolo lock condiviso che ha risolto. Copiabile in qualsiasi repository.
Come Eseguire da 3 a 8 Agenti di Codifica in Parallelo Senza Perdere il Controllo
Lanciare più agenti Claude Code o Codex contemporaneamente è facile. Mantenere il controllo è dove tutto si complica. Ecco il metodo che funziona davvero.
Potrebbe interessarti anche
Gestione delle attività
Bacheca kanban visiva per orchestrare gli agenti IA con il trascinamento. Crea attività in TODO, trascinale su In Corso per avviare automaticamente un agente Claude e segui l'avanzamento nelle colonne In Attesa e Fatto. Sviluppo guidato dal backlog per il coding IA in parallelo.
Review per Agente
Revisiona le modifiche al codice di ogni agente AI separatamente. AgentsRoom traccia quale agente Claude Code ha modificato quali file. Filtra i diff per agente, revisiona individualmente, commit per agente per una cronologia git pulita.
Multi-progetto · Multi-agente · Parallelo
AgentsRoom fa girare in parallelo più agenti IA su più progetti, tutto in un'unica finestra: Claude, Codex, GitHub Copilot CLI, Cursor e altre 10 CLI di agenti. Ruoli con codice colore, stato in tempo reale, contatori per progetto, notifiche native su desktop e mobile. L'alternativa visiva a 12 schede di terminale e al caos delle sessioni Claude Code sparse tra iTerm2, Warp e tmux.
Personalizza gli Agenti
Scegli tra 14 ruoli di agente predefiniti, aggiungi agenti specialisti da The Agency, o costruisci il tuo agente AI di codifica personalizzato con il proprio prompt di sistema. Poi condividi i tuoi agenti con il tuo team attraverso la chat e pubblicali nella comunità affinché tutti possano crescere insieme.
Workflow Multi-Agente : Handoff : Feedback Loop
AgentsRoom Agent Teams concatena agenti di codice IA come un vero team di ingegneria. Editor visuale di workflow (canvas in stile n8n) per collegare i ruoli Dev, QA, PM, Security e DevOps. Handoff automatico con riepilogo, diff git, rischi e suggerimenti di test. Quality gate verificati dalla macchina (decide la tua suite di test, non l'agente), rami di revisione QA e Security in parallelo, collegamenti condizionali, cicli di feedback, tetto max-cycles. Scegli per ogni team come girano i ruoli: un agente che fa morph da un ruolo all'altro e tiene tutto il contesto, oppure un agente vivo per ruolo, che si scrivono in tempo reale. L'orchestratore multi-agente che mancava ai tuoi agenti, su Claude, Codex, GitHub Copilot CLI, Cursor e altre 10 CLI di agenti.
Dai a ogni agente il proprio checkout
Scarica AgentsRoom per macOS, Windows o Linux e lascia che più agenti lavorino sullo stesso repository senza pestarsi i piedi.
App companion: monitora i tuoi agenti in movimento
Usa Claude, Codex, Antigravity CLI o un altro provider IA.
Invia bug e richieste direttamente nel tuo backlog pubblico.