Un gestionnaire de worktrees git
pour Claude Code, Codex et tous les CLI d'agents
Coche une case sur un ticket, ou choisis un worktree quand tu ajoutes un agent, et il travaille dans son propre checkout, sur sa propre branche. Plusieurs agents modifient le même dépôt en même temps sans toucher aux fichiers des autres.
Avant que l'agent démarre, AgentsRoom installe les dépendances et copie tes fichiers .env dans le nouveau worktree, pour qu'il puisse compiler et lancer les tests tout de suite. Quand il a fini, tu relis, commites, pousses et fusionnes ce worktree depuis l'onglet Changements, sur l'ordinateur ou depuis ton téléphone.
- Agent backend.worktrees/fix-login-redirectPréparé
- Agent frontend.worktrees/settings-dark-modeAu travail
- Agent QA.worktrees/agents/qaRelecture
Trois agents, trois worktrees, un seul dépôt : chaque checkout est préparé avant que son agent démarre, puis relu et fusionné à part.
Deux agents dans le même checkout, c'est deux personnes qui tapent dans le même fichier. L'un lance le formateur pendant que l'autre est au milieu d'une modification, l'un change de branche sous les pieds de l'autre, et le diff que tu relis à la fin mélange les deux travaux. Un worktree git règle ça : un deuxième checkout du même dépôt, dans son propre dossier et sur sa propre branche, qui partage l'historique mais pas les fichiers.
En créer un tient en une commande git. Vivre avec dix, c'est autre chose : un worktree neuf n'a ni node_modules ni .env, donc le premier build de l'agent échoue ; rien ne te dit quel agent travaille où ; et quand le travail est fini, il faut encore retrouver le dossier, le relire, le commiter et le fusionner.
AgentsRoom s'occupe de ce cycle. Un ticket du backlog ou un agent demande un worktree, AgentsRoom le crée depuis une branche de base à jour, dans le projet sous .worktrees/, le prépare, y lance l'agent, et te donne un sélecteur dans l'onglet Changements pour le relire, le commiter, le pousser et le fusionner. Ça marche de la même façon quel que soit le CLI qui fait tourner l'agent : Claude, Codex, GitHub Copilot CLI, Cursor et 10 autres CLI d'agents.
Les worktrees restent facultatifs. Un agent sans worktree continue de travailler dans le dossier du projet comme avant, et tu décides par ticket, par agent ou par modèle d'agent.
Ce que fait le gestionnaire de worktrees
Du moment où une tâche demande un checkout isolé jusqu'au moment où sa branche est fusionnée.
Un worktree par ticket du backlog
Coche Coder dans un worktree séparé pour cette tâche sur un ticket, choisis un des worktrees du projet ou tape le nom d'une nouvelle branche, et le démarrage du ticket crée le worktree et y lance l'agent.
Choisir un worktree en ajoutant un agent
La carte Espace de travail de la fenêtre Ajouter un agent propose Principal, les worktrees existants du projet et Nouveau. Un worktree que tu as créé toi-même avec git worktree add apparaît aussi.
Un nouveau worktree pour chaque agent d'un modèle
Active Nouveau worktree par agent sur un agent enregistré ou un profil par défaut, et chaque agent créé depuis lui reçoit sa propre branche, nommée agents/<modèle> puis -2, -3 : les copies ne partagent jamais un checkout.
Prêt à compiler dès le premier lancement
Avant que le premier agent démarre dans un nouveau worktree, AgentsRoom copie les fichiers ignorés par git dont il a besoin (tous les fichiers .env par défaut) et lance la commande d'installation détectée depuis ton lockfile : yarn, pnpm, npm, bun, uv, poetry, pipenv, bundle ou composer.
Relire, commiter et pousser chaque worktree
Le sélecteur Worktree en haut de l'onglet Changements bascule le diff, la relecture, Commit, Pull et Push sur ce checkout. Un clic sur la pastille d'un agent qui a son propre worktree l'ouvre directement.
Fusionné quand le ticket est terminé
Avec Fusionner automatiquement dans la branche courante quand la tâche est terminée, passer le ticket en Terminé fusionne sa branche. Active Commiter automatiquement à la fin du travail pour que ce que l'agent a laissé sans commit fasse partie de la fusion.

Comment ça marche
Le parcours d'un ticket, du formulaire à la fusion.
- 1
Demander un worktree sur le ticket
Dans le formulaire du ticket, zone Exécution, coche Coder dans un worktree séparé pour cette tâche. Choisis un worktree existant parmi les pastilles, ou garde le champ Nom de la branche : il est prérempli depuis le titre tant que tu ne le modifies pas, et devient un nouveau worktree au démarrage de la tâche.
- 2
Démarrer le ticket
AgentsRoom récupère la branche de base (la branche par défaut du remote, ou la Branche de base des worktrees réglée dans les paramètres du projet), crée le worktree sous .worktrees/<branche>/ et ajoute ce dossier au .git/info/exclude du clone, pour qu'il n'apparaisse jamais comme fichiers non suivis dans ton checkout principal.
- 3
Le worktree est préparé, puis l'agent démarre
Le terminal de l'agent affiche la commande d'installation et sa sortie, une notification dit combien de fichiers ignorés ont été copiés, puis le CLI de l'agent démarre dans le worktree. Ça n'arrive qu'une fois par worktree ; une installation qui échoue ne bloque jamais l'agent, l'erreur reste dans son terminal.
- 4
Relire et fusionner
Choisis le worktree dans l'onglet Changements pour lire le diff et commiter. Passe le ticket en Terminé et, avec la fusion automatique activée, sa branche est fusionnée dans la branche courante ; la confirmation affiche le résultat. Le worktree reste sur le disque pour un dernier coup d'œil.

Claude Code et Codex créent déjà des worktrees. Voici la différence.
Claude Code a son propre drapeau : claude --worktree feature-auth crée .claude/worktrees/feature-auth sur une branche nommée worktree-feature-auth, copie les fichiers ignorés par git listés dans un fichier .worktreeinclude, et demande s'il faut garder ou supprimer le worktree quand tu quittes. Sa documentation dit clairement qu'un worktree est un checkout neuf et que c'est à toi d'installer les dépendances, ou de le demander à Claude. Les subagents peuvent aussi recevoir chacun un worktree avec isolation: worktree.
L'app Codex gère des worktrees dans $CODEX_HOME/worktrees, les démarre en HEAD détachée depuis la branche choisie, lit elle aussi .worktreeinclude, lance les scripts de setup d'un environnement local si tu en choisis un, et garde les 15 plus récents par défaut. Handoff déplace une conversation et son code entre Local et un worktree. codex-cli 0.162.1 a aussi un drapeau --worktree.
Les deux sont bien faits, et chacun appartient à un seul éditeur. AgentsRoom ne les remplace pas : il place la même isolation un cran plus haut, là où vivent tes tickets et tes agents, pour tous les CLI à la fois, prépare le checkout avant que l'agent le voie, et garde la relecture, le commit et la fusion dans la fenêtre que tu utilises déjà. Vérifié sur Claude Code 2.1.299 et codex-cli 0.162.1, en octobre 2026.
Ce qu'il faut savoir
- Un worktree n'est jamais supprimé automatiquement, exprès, pour que tu puisses le relire. Ils s'accumulent sous .worktrees/ ; supprime-en un avec git worktree remove quand tu as fini, jamais pendant qu'un agent tourne encore dedans.
- Une fusion automatique qui tombe sur un conflit écrit un avertissement et le ticket passe quand même en Terminé : cette fusion se résout à la main.
- Les worktrees demandent un dépôt git à la racine du projet. Un dossier qui ne fait que regrouper plusieurs dépôts côte à côte n'en a pas : ouvre chaque dépôt comme un projet à part.
- Un projet ouvert sur un serveur SSH a ses worktrees sur le serveur, sans l'étape d'installation. Un checkout local dont les agents tournent sur une machine distante ne peut pas utiliser de worktrees, et le ticket le dit au lieu de démarrer.
- Un agent QA n'a jamais son propre worktree : il teste dans le checkout de son agent maître, parce qu'un worktree neuf ne contiendrait pas le travail non commité qu'il doit tester.
Questions fréquentes
C'est quoi un worktree git, et pourquoi en donner un à un agent IA ?
Un worktree git est un deuxième checkout du même dépôt, dans son propre dossier et sur sa propre branche, qui partage l'historique et le remote avec ton checkout principal. En donner un à chaque agent de code IA, c'est laisser chaque agent modifier, compiler et commiter sa propre copie des fichiers : deux agents qui travaillent en même temps ne s'écrasent jamais et ne changent jamais de branche sous les pieds l'un de l'autre. Notre blog a un guide plus long sur la partie git : Git worktrees, la base pour faire coder plusieurs agents sans conflit.
Claude Code a-t-il des worktrees intégrés ?
Oui. claude --worktree <nom> (ou -w) crée .claude/worktrees/<nom> sur une branche nommée worktree-<nom>, copie les fichiers ignorés par git listés dans .worktreeinclude, et demande s'il faut garder ou supprimer le worktree quand tu quittes ; les subagents peuvent tourner dans leur propre worktree avec isolation: worktree. Il n'installe pas tes dépendances. Dans AgentsRoom, tu peux continuer à t'en servir, ou laisser le ticket ou l'agent demander le worktree, ce qui le prépare aussi et l'affiche dans l'onglet Changements (vérifié sur Claude Code 2.1.299).
Codex gère-t-il les worktrees ?
L'app Codex, oui : elle crée des worktrees gérés dans $CODEX_HOME/worktrees, en HEAD détachée, copie les fichiers ignorés listés dans .worktreeinclude, peut lancer les scripts de setup d'un environnement local, garde les 15 plus récents et déplace une conversation entre Local et un worktree avec Handoff. codex-cli 0.162.1 a un drapeau --worktree qui lance une session dans un nouveau worktree géré. AgentsRoom donne un worktree à un agent Codex de la même façon qu'à n'importe quel autre agent, depuis le ticket ou la fenêtre Ajouter un agent.
Quels CLI d'agents peuvent tourner dans un worktree AgentsRoom ?
Tous : le worktree est simplement le dossier de travail de l'agent, quel que soit le CLI qui y tourne, donc Claude, Codex, GitHub Copilot CLI, Cursor et 10 autres CLI d'agents y travaillent de la même façon. Kimi Code et Antigravity CLI font confiance à un dossier par son chemin exact ; AgentsRoom enregistre un nouveau worktree comme dossier de confiance pour eux avant le lancement, pour qu'ils ne s'arrêtent pas sur une question de confiance.
Dois-je lancer yarn install et copier mon .env dans chaque worktree ?
Non. Avant que le premier agent démarre dans un nouveau worktree, AgentsRoom copie les fichiers ignorés par git du checkout principal qui correspondent à Fichiers copiés depuis ce checkout (tous les fichiers .env par défaut) et lance la commande d'installation détectée depuis le lockfile à la racine. Les deux se règlent dans Paramètres du projet > Git > Préparer les nouveaux worktrees, où tu peux remplacer la commande, par exemple pnpm install && pnpm build:deps. Un fichier déjà présent dans le worktree n'est jamais écrasé.
Comment relire et fusionner ce qu'un agent a fait dans son worktree ?
Ouvre l'onglet Changements et choisis le worktree dans le sélecteur Worktree en haut : la liste des fichiers, les diffs, la relecture, Commit, Pull et Push agissent alors sur ce checkout. Pour un ticket, Fusionner automatiquement dans la branche courante quand la tâche est terminée fusionne sa branche quand tu le passes en Terminé, et Commiter automatiquement à la fin du travail (Réglages > Backlog) commite d'abord ce que l'agent a laissé, pour que la fusion emporte tout le travail.
Où sont les worktrees, et sont-ils nettoyés ?
Dans le projet, sous .worktrees/<branche>/, créés depuis la branche par défaut du remote sauf si tu règles une Branche de base des worktrees dans les paramètres du projet. Le dossier est ajouté au .git/info/exclude du clone, jamais à ton .gitignore, donc il reste hors de tes commits. Les worktrees ne sont jamais supprimés automatiquement : supprime-en un avec git worktree remove quand tu en as fini.
Puis-je utiliser les worktrees depuis mon téléphone ou sur un serveur distant ?
Oui pour les deux. Sur le téléphone, l'écran Changements a le même sélecteur Worktree, et un ticket qui demande un worktree tourne dedans quand tu le démarres depuis le téléphone, préparé par l'ordinateur comme n'importe quel autre. Un projet ouvert sur un serveur SSH a ses worktrees sur le serveur, sans l'étape d'installation. Un checkout local dont les agents tournent sur une machine distante ne peut pas utiliser de worktrees, et le ticket te le dit au lieu de démarrer.
Pour aller plus loin
Git worktrees : la base pour faire coder plusieurs agents sans conflit
Tes agents se marchent dessus quand ils tournent en parallèle. Les git worktrees règlent ça en deux commandes. Voici comment t'en servir.
Dix agents ont lancé le même typecheck en même temps. La solution était un dossier.
Dix-sept agents de code dans le même checkout, dix tsc en parallèle, load average 37 et 87 Mo de RAM libre. Un typecheck de quatre-vingt-dix secondes a mis 7 min 36. Voici la mesure, pourquoi la machine ne calculait pas, et le petit verrou partagé qui a réglé le problème. Recopiable dans n'importe quel dépôt.
Faire tourner 3 à 8 agents de code en parallèle sans perdre le fil
Lancer plusieurs agents Claude Code ou Codex en même temps, c'est facile. Garder le contrôle, c'est là que ça coince. Voici la méthode qui marche.
Ça pourrait aussi t'intéresser
Gestion de tâches
Tableau kanban visuel pour orchestrer vos agents IA par glisser-deposer. Créez des tâches dans TODO, glissez-les vers En Cours pour lancer automatiquement un agent Claude, et suivez l'avancement dans les colonnes En Attente et Termine. Développement pilote par le backlog avec du codage IA en parallele.
Revue par Agent
Examinez les modifications de chaque agent IA séparément. AgentsRoom identifié quel agent Claude Code a modifié quels fichiers. Filtrez les diffs par agent, relisez individuellement, commitez par agent pour un historique git propre.
Multi-projet · Multi-agent · Parallèle
AgentsRoom fait tourner plusieurs agents IA en parallèle, sur plusieurs projets en même temps, dans une seule fenêtre : Claude, Codex, GitHub Copilot CLI, Cursor et 10 autres CLI d'agent. Code couleur par rôle, statut en direct, compteurs par projet, notifications bureau et mobile. L'alternative visuelle aux 12 onglets de terminal et au chaos des sessions Claude éparpillées dans iTerm2, Warp et tmux.
Personnaliser les agents
Choisissez parmi 14 rôles d'agents intégrés, ajoutez des agents spécialisés de The Agency, ou construisez votre propre agent de codage IA personnalisé avec son propre prompt système. Ensuite, partagez vos agents avec votre équipe via le chat, et publiez-les dans la communauté pour que tout le monde progresse ensemble.
Workflow multi-agents • Handoff • Boucle de feedback
AgentsRoom Agent Teams enchaîne vos agents de code IA comme une vraie équipe d'ingénierie. Éditeur de workflow visuel (canvas façon n8n) pour câbler les rôles Dev, QA, PM, Sécurité et DevOps. Handoff automatique avec résumé, diff git, risques et pistes de test. Portes de qualité vérifiées par la machine (votre suite de tests décide, pas l'agent), branches de relecture QA et Sécurité en parallèle, liens conditionnels, boucles de feedback, garde-fou max-cycles. Choisissez pour chaque équipe comment tournent les rôles : un agent qui morphe de rôle en rôle et garde tout le contexte, ou un agent vivant par rôle, qui s'écrivent en temps réel. L'orchestrateur multi-agents qui manquait à vos agents, sur Claude, Codex, GitHub Copilot CLI, Cursor et 10 autres CLI d'agent.
Donne à chaque agent son propre checkout
Télécharge AgentsRoom pour macOS, Windows ou Linux et laisse plusieurs agents travailler sur le même dépôt sans se marcher dessus.
App companion : suivez vos agents en déplacement
Utilisez Claude, Codex, Antigravity CLI ou un autre fournisseur IA.
Remontez bugs et demandes directement dans votre backlog public.