OpenCode Worktree: isolare attività di programmazione con Git

Un Git worktree è un’altra directory di lavoro collegata allo stesso repository. Il checkout principale può restare su main, mentre una cartella vicina usa work/auth. File e branch attivo sono distinti; Git condivide comunque oggetti e cronologia, quindi di solito non serve clonare tutto il repository per ogni attività.

Questo flusso non richiede una modalità worktree speciale di OpenCode. Avvia la CLI dalla nuova directory, che diventa il contesto del progetto. Le impostazioni globali possono restare attive, ma file non tracciati e configurazione locale dell’ambiente non vengono copiati automaticamente.

Per prima cosa controlla il checkout attuale. Un punto di partenza pulito aiuta a distinguere le modifiche della nuova attività. Dalla radice del repository crea un branch e il relativo worktree in una cartella vicina, fuori dalla directory originale.

L’esempio crea work/auth dal commit corrente e lo posiziona in ../app-auth. Se il branch esiste già, verifica che non sia attivo in un altro worktree prima di riutilizzarlo. Git normalmente impedisce di usare lo stesso branch in più worktree collegati contemporaneamente.

Esegui questi comandi dalla radice del repository principale. Il nuovo branch parte dal commit corrente.

git status --short --branch
git worktree add -b work/auth ../app-auth
cd ../app-auth
opencode
git worktree list
git -C ../app-auth status --short --branch

Dopo cd ../app-auth, esegui opencode in quella shell. La directory corrente è il confine importante: usa un terminale o una sessione per worktree e controlla la radice del progetto prima di consentire modifiche. Una prima richiesta di sola lettura può riassumere il branch e i file da esaminare.

Assegna a ogni sessione un’attività precisa e annota il branch. Una cartella può aggiornare i test di autenticazione e un’altra la documentazione. Evita che due sessioni modifichino lo stesso file o scrivano nella stessa cartella generata. Cartelle separate riducono collisioni, ma non coordinano automaticamente gli agenti.

Il worktree separa file Git e indice, ma non è un container né un confine di sicurezza. Un database locale, un server di test, una cache, un progetto Docker o un account esterno può restare condiviso. Se serve, separa schema, porta, nome del progetto oppure usa un ambiente temporaneo.

Git ripristina i file tracciati dal commit scelto. .env, certificati, cache e output ignorati potrebbero non comparire nel nuovo worktree. Ricrea solo l’ambiente necessario, carica i segreti con il metodo approvato e controlla git status --short --branch prima e dopo il lavoro.

Revisiona il branch del worktree come modifica indipendente. Controlla git diff, esegui le verifiche del progetto da quella directory e conferma che ci siano solo file previsti. Dopo i test, fai merge o rebase secondo il processo del team. Le modifiche non appaiono in altri checkout finché i commit non vengono condivisi.

Prima di rimuovere il worktree controlla le modifiche non confermate e decidi se salvarle, confermarle o conservarle. git worktree remove ../app-auth elimina un checkout pulito; Git rifiuta l’operazione se ci sono modifiche, salvo forzatura. Non usare la forza come pulizia normale. git worktree prune rimuove registrazioni obsolete, non cartelle attive.

Scegli un worktree quando servono branch, snapshot dei file o confini di revisione distinti che possono restare aperti per giorni. Per una ricerca in sola lettura o che deve vedere file non confermati, è più semplice aprire un’altra sessione nello stesso checkout. Per attività sequenziali basta cambiare branch.

Un worktree aggiunge gestione di nomi branch, dipendenze, servizi, test, merge e pulizia. Se più agenti modificano gli stessi file, l’integrazione può diventare più difficile. Dividi prima il lavoro in modifiche non sovrapposte oppure esegui le modifiche in sequenza.

Se git worktree add segnala che un branch è già attivo, consulta git worktree list e crea un altro branch o torna al worktree esistente. Se OpenCode mostra file inattesi, controlla il percorso del terminale e la radice del progetto prima di cambiare configurazione. I file ignorati non fanno parte del checkout.

Se i test di sessioni diverse interferiscono, cerca fuori da Git: database, porte, cartelle temporanee, generatori e cache condivise. Se la rimozione è bloccata, esegui git status nel worktree e conserva le modifiche utili. Tieni il checkout principale disponibile per integrare il lavoro.