Worktrunk git worktree : le dépôt max-sixty/worktrunk est une ligne de commande, écrite en Rust, qui simplifie la gestion des worktrees Git. Son README la décrit comme « conçue pour lancer des agents d’IA en parallèle ». Elle est publiée sous double licence MIT ou Apache 2.0, au choix. Le README se présente comme le gestionnaire de worktrees Git le plus populaire : c’est une affirmation du projet, que nous ne reprenons pas à notre compte.
Le problème est concret. Quand cinq ou dix agents de code travaillent en parallèle, chacun a besoin de son propre répertoire de travail. Les worktrees natifs de Git le permettent, mais la syntaxe est lourde. Comment Worktrunk allège-t-il ce geste, comment l’installer, et que peut-on observer quand l’outil tourne sur un poste de développement ?
Précision d’honnêteté : span.observer n’a pas installé ni lancé Worktrunk. Les commandes viennent du README et de la documentation du dépôt (dossier docs/, publiée sur worktrunk.dev), lus le 5 novembre 2026. Les captures reproduisent leurs exemples. Le nombre d’étoiles n’a pas pu être relu à la source : il n’est donc pas cité.
Worktrunk git worktree : ce que dit le dépôt
- Licence : le fichier LICENSE reprend les textes MIT et Apache 2.0 ;
Cargo.tomlindiqueMIT OR Apache-2.0. - Version :
Cargo.tomlet la première entrée du journal des modifications portent la version 0.81.0. La date de cette version n’est pas indiquée dans le journal : nous ne la citons pas. Le numéro 0.x signale un projet encore jeune. - Principe : les worktrees sont adressés par nom de branche, et le chemin se calcule à partir d’un gabarit configurable. Trois commandes forment le cœur :
wt switch,wt listetwt remove, pluswt mergepour fusionner. - Agents : des plugins existent pour Claude Code, Codex, OpenCode, Pi, oh-my-pi et Gemini CLI. Selon la documentation, ils apportent un suivi d’activité dans
wt list, et l’isolation des worktrees pour Claude Code et OpenCode seulement.
Le README compare les commandes à Git seul : créer un worktree et lancer Claude passe de trois commandes enchaînées (git worktree add -b, cd, claude) à wt switch -c -x claude feat.
Visite des commandes et de la documentation
La première capture reprend le démarrage rapide du README : création d’un worktree puis liste de l’état de chaque branche. Les colonnes Commit, Age et Message ont été retirées pour tenir en 860 px ; le reste est reproduit tel quel.

La documentation explique les symboles : @ marque le worktree courant, + des changements indexés, ↑1 un commit d’avance sur main et ⇡ des commits non poussés. Pour plusieurs agents, le README donne trois commandes wt switch -x claude -c, l’option -x lançant une commande après le changement de worktree. Les hooks de la documentation s’écrivent en TOML, et la deuxième capture les rapproche.

Dans cet exemple de la documentation, install tourne d’abord, puis build et server s’exécutent ensemble. Les hooks post-* s’exécutent en arrière-plan.
Installation pas à pas
Étape 1 : installer la commande wt
Le README propose Homebrew (macOS et Linux), Cargo, et d’autres gestionnaires :
brew install worktrunk && wt config shell install
# ou
cargo install worktrunk && wt config shell install
L’intégration au shell permet aux commandes de changer de répertoire. Sous Windows, la commande wt entre en conflit avec celle de Windows Terminal : Winget installe donc l’outil sous le nom git-wt (winget install max-sixty.worktrunk, puis git-wt config shell install). La FAQ précise que Git for Windows est requis, car les hooks s’exécutent via Git Bash. Elle indique aussi Git 2.43 ou plus récent comme prérequis. Arch Linux (pacman) et Conda ou Pixi sont aussi listés.
Étape 2 : créer un worktree
- Dans un dépôt Git, lancez
wt switch --create feature-auth: la commande crée la branche depuis la branche par défaut et le worktree. - Travaillez, puis contrôlez l’ensemble avec
wt list. - Terminez par le flux de pull request (
wt step commit,gh pr create, puiswt removeaprès la fusion) ou parwt merge main, qui regroupe squash, rebase, fusion et nettoyage.
Étape 3 : lancer plusieurs agents
wt switch -x claude -c feature-a -- 'Add user authentication'
wt switch -x claude -c feature-b -- 'Fix the pagination bug'
Les arguments après -- sont transmis à la commande lancée. Selon la documentation, wt switch exécute d’abord les hooks pre-start, bloquants, puis lance les hooks post-start en arrière-plan.
Étape 4 (facultative) : le plugin de l’agent
wt config plugins claude install
Le plugin ajoute des marqueurs d’activité dans wt list : 🤖 quand l’agent travaille, 💬 quand il attend. La troisième capture reproduit l’exemple de la documentation.

Limites et points ouverts
- Maturité : version 0.81.0, et un journal des modifications qui signale des changements incompatibles (« Breaking ») dans cette même version, notamment sur les hooks et les gabarits. Relisez-le avant chaque mise à jour.
- Hooks et sécurité : les commandes des hooks de projet demandent une approbation à la première exécution, enregistrée dans
~/.config/worktrunk/approvals.toml. L’option--yescontourne les questions : réservez-la à l’intégration continue. Un hook de projet exécute des commandes issues du dépôt, donc relisez.config/wt.tomld’un dépôt tiers avant d’approuver. - Agents en parallèle : la documentation prévient que des hooks concurrents peuvent entrer en concurrence sur un même fichier. Utilisez des blocs ordonnés pour les commandes dépendantes. Voyez aussi les garde-fous des agents IA en production.
- Disque : chaque worktree ajoute une copie des fichiers suivis. La copie des caches de build (
wt step copy-ignored) partage les blocs disque seulement sous APFS, btrfs et XFS, pas sous ext4 ni NTFS. - Branches empilées : non prises en charge nativement, d’après la FAQ.
- Intégrations : les statuts de CI passent par la CLI de la forge (
gh,glab,teaouaz) et réclament le réseau avec--full.
Observer Worktrunk et ses agents
Worktrunk est une ligne de commande locale, pas un service. Le dépôt ne documente ni métriques ni export OpenTelemetry, et la documentation affirme que l’outil ne collecte aucune télémétrie ni statistique d’usage : nous n’en supposons donc aucune. Ce qui existe est documenté :
- Journal des commandes :
.git/wt/logs/commands.jsonl, une ligne JSON par exécution de hook ou de commande LLM, avec les champsts,wt,label,cmd,exitetdur_ms. Il pivote à 1 Mo. - Journaux des hooks en arrière-plan : un fichier par hook sous
.git/wt/logs/{branche}/{source}/{type-de-hook}/{nom}.log, listés parwt config state logs. - Diagnostic : l’option
-vvécrittrace.log,trace.jsonletsubprocess.log, etwt config state logs profilerésume les durées. - État des agents : les marqueurs 🤖 et 💬 de
wt list. Un marqueur peut rester si l’agent est tué avant la fin de session ;wt config state marker clearl’efface.
Pour mesurer ce que font les agents eux-mêmes (coût, appels d’outils, durées), la démarche relève de l’instrumentation de l’agent : voyez la supervision d’un agent de code en entreprise. Pour piloter une flotte d’agents, comparez avec Orca.
Et Dynatrace ?
Worktrunk ne documente aucune intégration Dynatrace, et nous n’en inventons pas. Le fichier commands.jsonl peut être lu par un collecteur de logs ; la configuration relève alors de la documentation de l’outil de collecte utilisé.
Bonnes pratiques
- Un worktree par agent et par tâche, nommé d’après la branche, puis
wt removeune fois la fusion faite. - Mettez l’installation des dépendances en
pre-startet les serveurs de développement enpost-start, comme le recommande la documentation. - Relisez les hooks de projet avant de les approuver, et ne mettez aucun secret dans
.config/wt.toml. - Consultez
commands.jsonlquand un hook échoue : le code de sortie et la durée s’y trouvent. - Outillez vos agents avec un serveur MCP de confiance, par exemple le serveur MCP GitHub.
Questions fréquentes
Worktrunk remplace-t-il git worktree ?
Non : l’outil s’appuie sur Git et ses worktrees. Il ajoute l’adressage par branche, les hooks, la liste d’état et le flux de fusion. Vos worktrees restent des worktrees Git ordinaires.
Worktrunk fonctionne-t-il avec d’autres agents que Claude Code ?
Selon la documentation, des plugins existent pour Codex, OpenCode, Pi, oh-my-pi et Gemini CLI. Les fonctions diffèrent : l’isolation des worktrees n’existe que pour Claude Code et OpenCode. Les autres agents s’utilisent avec wt switch --create et wt remove.
Worktrunk envoie-t-il des données ?
La documentation affirme qu’il ne collecte aucune télémétrie. Il lance git et, en option, la CLI de la forge pour le statut de CI, ainsi que les commandes LLM que vous configurez vous-même.
Conclusion
Worktrunk réduit le travail répétitif autour des worktrees Git, ce qui compte dès que plusieurs agents de code tournent en parallèle. L’outil est jeune et change vite, et il ne documente aucune métrique : l’observation repose sur ses journaux et sur l’instrumentation des agents. Testez-le sur un dépôt sans enjeu avant de généraliser.
span.observer est un blog indépendant de la communauté, non affilié à Worktrunk ni à son auteur, ni à Dynatrace LLC. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle.