Worktree

Creare un worktree#

1. In un pannello dentro il repository, fai clic su Worktree nella barra del pannello (disponibile anche nell’elenco dei branch).
2. In Crea da, scegli Ramo o Pull request.
3. Scegli il Branch di base (o la pull request) e inserisci il nome del Nuovo branch.
4. Scegli Dove crearlo e, se vuoi, una nota per la sessione.
5. Premi Crea. Si apre una nuova sessione nella cartella del worktree.

Dove vanno i worktree#

Fuori dal repository (predefinito)

I worktree vengono raggruppati in una cartella con il nome del repository, ad es. ~/worktrees/acme-app/feature-login. Inserisci un percorso assoluto, ~ o ... Il tuo .gitignore non viene toccato.

Dentro il repository

I worktree finiscono in una cartella all’interno del repository. Se quella cartella non è ancora ignorata, viene aggiunta al .gitignore della radice (come una normale modifica al codice).

Copiare i file ignorati#

Un worktree appena creato non contiene nessuno dei file ignorati da Git, quindi di solito non può ancora funzionare. Con File ignorati: Copia da questo checkout (il valore predefinito), PATerminal copia file come .env, node_modules e .venv dal checkout corrente al nuovo worktree, mostrando l’avanzamento. Scegli Non copiare per saltare questo passaggio.

Worktree da una pull request#

Scegli Pull request come sorgente per elencare le pull request aperte (tramite il tuo gh). PATerminal crea un worktree sul branch della PR e lo apre come sessione — ideale per revisionare o correggere una PR mentre il checkout principale continua a lavorare. Un worktree già esistente per quel branch viene riutilizzato.

Gestire i worktree#

L’elenco dei worktree nella finestra Git mostra ogni worktree con il suo branch e lo stato (corrente, principale, bloccato, mancante). Rimuovine uno, oppure selezionane diversi e premi Rimuovi selezionati. Rimuovere un worktree mantiene il suo branch; il worktree principale e quello corrente non si possono rimuovere. Forza la rimozione viene proposto quando Git rifiuta a causa di modifiche locali.

Impostazioni predefinite dei worktree#

Impostazioni → Posizione predefinita del worktree imposta la posizione predefinita e se copiare i file ignorati. Attiva Automatically fill in the branch name per ottenere un nome composto da data, ora e un breve suffisso casuale. Queste impostazioni valgono anche quando un worktree viene creato da una issue o dalla modalità pair.