Git worktrees : la base pour faire coder plusieurs agents sans conflit

Tu lances deux agents sur le même repo. L'un modifie package.json, l'autre aussi. Trente secondes plus tard, ton code est dans un état que personne ne peut merger.

Ce n'est pas un bug de tes agents. C'est qu'ils travaillent tous dans le même dossier.

La solution tient en un outil que Git a depuis des années et que presque personne n'utilise : git worktree.

Le problème : 3 agents, 1 repo, merge impossible

Un repo Git classique, c'est un dossier avec une seule branche checked out à la fois. Tu bosses sur main, tu changes de branche, tout le dossier bascule.

Maintenant colle trois agents autonomes dans ce dossier. Ils écrivent en même temps. Agent A crée un fichier, agent B fait un git checkout pour repartir propre, et il efface le travail en cours de A. Tu te retrouves avec des fichiers à moitié écrits, un index pourri, et des conflits que tu passes plus de temps à démêler que si tu avais codé toi-même.

Le parallélisme te fait gagner du temps seulement si les agents ne se touchent pas.

C'est quoi un git worktree

Un worktree, c'est un deuxième dossier de travail rattaché au même repo.

Même historique, même remote, mais chaque worktree a sa propre branche checked out et ses propres fichiers sur le disque. Tu peux en avoir cinq côte à côte, chacun sur une branche différente, sans qu'ils se gênent.

Un seul .git, plusieurs espaces de travail. C'est tout.

Un worktree par agent, en pratique

Voilà le setup. Depuis ton repo :

git worktree add ../projet-auth -b feature/auth
git worktree add ../projet-billing -b feature/billing
git worktree add ../projet-export -b feature/export

Tu viens de créer trois dossiers, chacun sur sa branche. Tu lances un agent dans chacun :

cd ../projet-auth && claude
cd ../projet-billing && codex

Chaque agent a son dossier, sa branche, ses fichiers. L'agent auth ne verra jamais ce que fait l'agent billing. Zéro collision possible.

Quand une feature est prête, tu reviews sa branche et tu merges. Puis tu nettoies :

git worktree remove ../projet-auth

Le dossier disparaît, la branche reste dans ton historique. Propre.

Les 3 pièges à connaître

Premier piège, le fichier central partagé. Si deux features doivent toucher le même routes.ts ou le même schéma de base, les worktrees ne te sauvent pas, tu auras le conflit au merge. Un seul agent touche les fichiers que tout le monde partage, les autres attendent ou contournent.

Deuxième, les branches qui divergent. Pendant que tes agents bossent, main avance. Trois jours plus tard, tes branches sont en retard et le merge devient pénible. Rebase tôt et souvent, ou garde des sessions courtes.

Troisième, le ménage oublié. Chaque worktree est un vrai dossier sur ton disque. Dix par jour sans nettoyage, et ton dossier parent devient illisible. git worktree list montre ce qui traîne, git worktree prune enlève les morts.

Le vrai sujet : qui surveille les cinq dossiers ?

Les worktrees règlent la collision de fichiers. Ils ne règlent pas ta charge mentale.

Tu as cinq dossiers, cinq agents, cinq terminaux. Lequel attend ta review ? Lequel a fini il y a dix minutes pendant que tu regardais ailleurs ? Lequel s'est planté ?

C'est là qu'un worktree par agent montre sa limite si tu restes en terminal. Tu as résolu le conflit technique, mais tu as multiplié les fenêtres à surveiller.

AgentsRoom met chaque agent sur une tuile, avec son statut et sa couleur, peu importe le worktree dans lequel il tourne. Un agent qui attend passe en rouge et te notifie. Lis comment faire tourner 3 à 8 agents en parallèle sans perdre le fil pour la méthode complète au-dessus des worktrees.

Ce que tu retiens

Un agent, un worktree, une branche. C'est la règle de base du multi-agent sérieux.

Les commandes tiennent en trois lignes, le bénéfice est immédiat : tes agents arrêtent de s'écraser entre eux. Ajoute une vue qui te dit lequel a besoin de toi, et tu tiens vraiment cinq chantiers en parallèle sans y laisser ta tête.