glossaire

qu’est-ce qu’un worktree git ?

Un worktree git est une copie séparée de votre dépôt sur sa propre branche. Il partage le même historique git que votre dépôt principal, mais possède ses propres fichiers dans son propre dossier. Vous pouvez en ouvrir autant que vous voulez à la fois.

le problème que les worktrees résolvent

En temps normal, votre dépôt se trouve dans un seul dossier, avec une seule branche extraite. Pour travailler sur deux fonctionnalités à la fois, vous devez mettre vos modifications de côté, changer de branche, faire l’autre travail, revenir sur la première branche, puis restaurer vos modifications. C’est pénible.

Avec les worktrees, vous obtenez un second dossier déjà placé sur une autre branche. Travaillez sur la fonctionnalité A dans un dossier et sur la fonctionnalité B dans l’autre. Rien à mettre de côté, aucune branche à changer. Les deux existent en même temps.

pourquoi c’est important pour les agents ia

Si vous lancez deux agents IA dans le même dossier, ils écraseront les modifications de l’autre. L’agent A modifie auth.ts. L’agent B modifie aussi auth.ts. Le dernier à enregistrer gagne. Le travail de l’autre agent disparaît.

Les worktrees règlent ce problème. Chaque agent reçoit son propre dossier, sa propre branche et sa propre copie des fichiers. Ils peuvent modifier auth.ts en même temps sans se gêner. Quand ils ont terminé, vous fusionnez chaque branche séparément.

à quoi ça ressemble sur le disque

my-project/              ← your main repo (main branch)
../my-project-feature-a/ ← worktree (feature-a branch)
../my-project-feature-b/ ← worktree (feature-b branch)

Les trois dossiers partagent le même historique git. Les modifications validées dans un worktree deviennent visibles dans les autres après la fusion. Mais les modifications de fichiers non validées restent totalement isolées.

comment pane automatise tout ça

Vous n’avez aucune commande git à lancer. Quand vous créez un nouveau pane dans Pane :

1. Pane crée le worktree et la branche pour vous.
2. Il copie vos variables d’environnement, node_modules et les autres dossiers importants. Votre agent peut commencer tout de suite.
3. Quand vous archivez le pane, Pane supprime automatiquement le worktree.

la méthode manuelle, pour référence

Si vous vouliez le faire sans Pane :

git worktree add ../feature-a feature-a
cd ../feature-a
claude   # start your agent here

# when done:
git worktree remove ../feature-a

Pane fait tout ça pour vous en un clic.

documentation associée

par Parsa Khazaeepoul

Dernière mise à jour le 24 juin 2026