Lancia dieci agenti in parallelo e il tuo repository Git si rompe per primo

Il discorso sugli agenti di codice è stato lo stesso tutto l'anno: girano senza supervisione, quindi conviene lanciarne diversi insieme. Cinque, dieci, di più. Uno sul refactoring dell'autenticazione, uno sul test instabile, uno sulla migrazione che nessuno vuole toccare.
Gli strumenti reggono abbastanza. Poi provi, e la cosa che si rompe è la tua directory di lavoro.
Due agenti nello stesso checkout si sovrascrivono i file a vicenda nel giro di un minuto. La soluzione è in git dal 2015: i worktree, che danno a ogni branch la propria directory condividendo un solo database di oggetti. Git sa farlo. L'interfaccia di git per farlo è abbastanza scarsa che quasi nessuno la usa.
Worktrunk è una CLI in Rust che sistema l'interfaccia. Ha 11.900 stelle, circa 2.200 delle quali dall'ultima settimana, ed è MIT o Apache-2.0 a seconda di quale preferisci.
Il problema delle tre digitazioni
Creare un worktree in git richiede di digitare il nome del branch tre volte:
git worktree add -b feat ../repo.feat cd ../repo.feat
Due di quei tre sono ridondanti. Esistono perché il comando vuole un percorso e un branch, e il percorso è quasi sempre derivabile dal branch. Sembra un piccolo fastidio. È la ragione per cui i worktree sono rimasti una tecnica per gente con opinioni forti invece che un default.
Worktrunk indirizza i worktree per nome di branch e calcola il percorso da un template configurabile. Ogni comando che accetta un branch accetta anche il percorso del worktree che lo contiene. Così la goffa danza in tre righe diventa:
wt switch -c -x claude feat
Crea un branch, crea il suo worktree e avvia Claude lì dentro, da dove ti trovi. Il flag -x esegue un comando dopo il cambio. Tutto ciò che aggiungi dopo un separatore viene passato a quel comando, ed è così che consegni all'agente la sua prima istruzione:
wt switch -x claude -c feature-auth
Tre di quelli in una sola shell e hai tre agenti su tre branch, isolati, senza alcun coordinamento tra loro.
Installazione
Homebrew su macOS o Linux: brew install worktrunk && wt config shell install. Cargo, pacman, conda-forge e pixi funzionano tutti. Su Windows è winget install max-sixty.worktrunk seguito da git-wt config shell install.
La nota su Windows vale la pena di ripeterla perché qualcuno ci inciamperà: wt punta già a Windows Terminal, quindi Winget installa lo strumento come git-wt per evitare la collisione. Puoi anche disattivare l'alias di Windows Terminal negli alias di esecuzione delle app e usare wt direttamente.
Il passo config shell install non è facoltativo. Installa l'hook di shell che permette a un comando di cambiare la directory corrente, ed è l'intero meccanismo dietro wt switch. Salta quello e ogni comando sembra non fare nulla.
I comandi che contano
Quattro coprono la maggior parte del flusso di lavoro.
wt switch ti sposta. wt list mostra ogni worktree con marcatori di stato: @ per dove sei, + per le modifiche in stage, ↑1 per un commit avanti rispetto a main, ⇡ per i commit non pushati. Già solo quell'output è meglio di git worktree list, che ti dà percorsi e nient'altro.
wt remove fa pulizia, eliminando worktree e branch insieme, che in git sono due comandi e un solo punto in cui sbagliare.
wt merge main è quello interessante. Fa squash del branch corrente, lo rebasa su main, fa fast-forward e rimuove il worktree, in un solo passo. Se ti è mai capitato di risolvere lo stesso conflitto tre volte su tre branch paralleli, sai perché esiste. Il parallelismo moltiplica il problema dei merge, e il problema dei merge era già la parte meno piacevole del lavoro.
C'è anche wt switch pr:123, che salta diretto al branch dietro una pull request. Funzione piccola, qualità della vita sproporzionata.
Lo spazio su disco è la parte di cui nessuno ti avverte
Dieci worktree significa dieci copie di node_modules e dieci copie di target/. Su un portatile sono centinaia di gigabyte, e il primo cargo build in ognuno richiede quattro minuti.
Worktrunk gestisce questo con cache di build copy-on-write. Sui file system che lo supportano, APFS su macOS, btrfs e XFS con reflink su Linux, i worktree condividono la directory di build e divergono solo quando un file cambia. La prima build paga. Le nove successive prendono in prestito.
È il tipo di funzione che rivela per cosa l'autore usa davvero lo strumento. Nessuno aggiunge cache di build condivise a un gestore di worktree per marketing. Le aggiunge dopo la quarta volta che il disco si è riempito.
Il dettaglio collegato è hash_port, un filtro di template che dà a ogni worktree una porta unica. Dieci worktree, dieci server di sviluppo, nessuna collisione di porte, nessuna contabilità manuale. Combinalo con un hook post-start che installa le dipendenze e avvia il server, e un nuovo worktree è pienamente operativo nel momento in cui l'agente parte.
Gli hook sono il lato affilato
Gli hook eseguono comandi di shell automaticamente in momenti definiti: dopo l'avvio di un worktree, prima di un merge, dopo un merge. Gli hook post-start sono il modo per ottenere la configurazione dell'ambiente gratis.
Sono anche esecuzione di codice arbitrario innescata da un'operazione git. Un repository può fornire una configurazione che esegue qualcosa su wt switch, e se lo cloni e passi a un branch, l'hai eseguito. È la stessa classe di rischio di npm install che esegue uno script postinstall, e merita lo stesso trattamento: leggi la configurazione prima di fidarti del repo.
La risposta dello strumento a questo è che gli hook sono dichiarati in una configurazione che controlli tu. Se basti dipende dal tuo modello di minaccia, e per chiunque cloni repository sconosciuti vale un pensiero.
Cosa non risolve
I worktree condividono una sola directory .git, il che significa che condividono riferimenti ai branch, stash e configurazione. Due agenti non possono fare checkout dello stesso branch. Un git rebase in un worktree cambia la storia su cui è seduto un altro worktree. Le voci di reflog si interlacciano in modi che rendono più difficile il lavoro forense.
Worktrunk rende piacevole il caso comune e non cambia il modello sottostante. Se i tuoi agenti hanno bisogno di repository davvero indipendenti, ti servono clone separati, e perdi l'archivio di oggetti condiviso che rende i worktree economici fin dall'inizio.
C'è anche un problema di coordinamento che lo strumento non tocca. Dieci agenti su dieci branch produrranno dieci pull request che toccano gli stessi tre file, e nessuna quantità di gestione dei worktree le farà unire in modo pulito. I team che ottengono valore dal parallelismo sembrano quelli che assegnano aree disgiunte, non quelli che lanciano più agenti.
Perché questo tipo di strumento sta guadagnando attenzione
I framework per agenti si prendono gli annunci. Le utility che rendono gli agenti utilizzabili si prendono le stelle.
Quel schema si è ripetuto tutto l'anno: livelli di memoria, modalità di permesso, sandbox, gestori di worktree. Ognuno esiste perché il modello è diventato abbastanza bravo da fare il lavoro e l'ambiente intorno non è mai stato progettato per un lavoratore che non si stanca, non fa domande e girerà volentieri per quaranta minuti nella directory sbagliata.
Worktrunk è una risposta piccola e mirata a una di quelle lacune. Le sue 11.900 stelle contano gli sviluppatori che hanno provato a lanciare tre agenti insieme e hanno scoperto che la parte difficile era il file system.
Articoli correlati
Un foglio di calcolo comunitario di tocchi che spegne la pubblicità negli Android cinesi
Non tocca il sistema, non sblocca niente, non flasha niente. Ribalta solo gli interruttori che i produttori hanno già previsto. Il prezzo è una lista che qualcuno deve continuare a scrivere.
GPT Image 2.6 ha tenuto il prezzo dei token e alzato la fattura
GPT Image 2.6 conserva ogni tariffa per token di 2.5 e costa comunque di più per immagine, perché buona parte del lavoro passa ora nei token di output. Undici giorni dopo il lancio, la struttura dei prezzi dice più della classifica.
Qualcuno ha ricostruito IDM dall'esterno e ha scritto cosa non ha toccato
Una reimplementazione in Rust di Internet Download Manager promette 5 volte la velocità e 86 lingue. Il documento più interessante è il paragrafo che spiega come è stata costruita senza copiare nulla.
Rune è un framework UI per Rust costruito perché un agente possa verificare il proprio lavoro
Rune renderizza headless, esporta il suo albero di elementi e accetta input scriptato, dando a un agente di coding un segnale diffabile che nessuno screenshot può offrire. Il framework è in pre-release e non accetta pull request.