Worktrees git

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.

Un dépôt, un checkout par agent
Checkout principalmain
  • 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.

Formulaire de tâche AgentsRoom avec Coder dans un worktree séparé pour cette tâche coché, les worktrees existants du projet fix-checkout-cache et free-shipping-coupon en pastilles, le nom de branche update-checkout-total-cache prérempli depuis le titre, et Fusionner automatiquement dans la branche courante quand la tâche est terminée coché
Une case à cocher sur la tâche : choisis un des worktrees du projet, ou garde le nom de branche prérempli depuis le titre, et décide si la branche est fusionnée quand la tâche est terminée.

Comment ça marche

Le parcours d'un ticket, du formulaire à la fusion.

  1. 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. 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. 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. 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.

Onglet Changements d'AgentsRoom avec le sélecteur Worktree ouvert sur Principal et deux worktrees d'agents, fix-checkout-cache sélectionné, et son fichier modifié src/checkout.js listé dessous
Le sélecteur Worktree de l'onglet Changements : choisis le worktree d'un agent, et le diff, le commit et le push agissent sur ce checkout.

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

Ç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.

GratuitTélécharger gratuitement

App companion : suivez vos agents en déplacement

Utilisez Claude, Codex, Antigravity CLI ou un autre fournisseur IA.

Installer l'extension
Chrome Web Store

Remontez bugs et demandes directement dans votre backlog public.

Multi-projets
Multi-provider
Multi-agents
Statut en direct
Diff & commit
App mobile
Aperçu live
Équipes d'agents
Tests navigateur
Dev pilotée par backlog
Bibliothèque de prompts
Bibliothèque de skills
Voir toutes les fonctionnalités