Worktrees

Créer un worktree#

1. Dans un volet situé dans le dépôt, cliquez sur Worktree dans la barre de volet (également disponible dans la liste des branches).
2. Sous Créer à partir de, choisissez Branche ou Pull request.
3. Choisissez la Branche de base (ou la pull request) et saisissez un nom de Nouvelle branche.
4. Choisissez Où le créer et, si vous le souhaitez, une note de session.
5. Appuyez sur Créer. Une nouvelle session s’ouvre dans le dossier du worktree.

Emplacement des worktrees#

Hors du dépôt (par défaut)

Les worktrees sont regroupés dans un dossier portant le nom du dépôt, par ex. ~/worktrees/acme-app/feature-login. Saisissez un chemin absolu, ~ ou ... Votre .gitignore n’est pas modifié.

Dans le dépôt

Les worktrees sont placés dans un dossier à l’intérieur du dépôt. Si ce dossier n’est pas encore ignoré, il est ajouté au .gitignore racine (comme une modification normale du code source).

Copier les fichiers ignorés#

Un worktree tout neuf ne contient aucun de vos fichiers ignorés par Git : il ne peut donc généralement pas encore tourner. Avec Fichiers ignorés : Copier depuis ce checkout (par défaut), PATerminal copie des fichiers comme .env, node_modules et .venv du checkout actuel vers le nouveau worktree, avec un indicateur de progression. Choisissez Ne pas copier pour sauter cette étape.

Worktree à partir d’une pull request#

Choisissez Pull request comme source pour lister les pull requests ouvertes (via votre gh). PATerminal crée un worktree sur la branche de la PR et l’ouvre comme session — idéal pour relire ou corriger une PR pendant que votre checkout principal continue de travailler. Un worktree existant pour cette branche est réutilisé.

Gérer les worktrees#

La liste des worktrees de la fenêtre Git affiche chaque worktree avec sa branche et son état (actuel, principal, verrouillé, manquant). Supprimez-en un, ou sélectionnez-en plusieurs et appuyez sur Supprimer la sélection. Supprimer un worktree conserve sa branche ; le worktree principal et le worktree actuel ne peuvent pas être supprimés. Forcer la suppression est proposé quand Git refuse à cause de modifications locales.

Réglages par défaut des worktrees#

Réglages → Emplacement par défaut du worktree définit l’emplacement par défaut et la copie ou non des fichiers ignorés. Activez Automatically fill in the branch name pour obtenir un nom formé de la date, de l’heure et d’un court suffixe aléatoire. Ces réglages s’appliquent aussi quand un worktree est créé depuis une issue ou par le mode binôme.