Lancez dix agents en parallèle et c'est votre dépôt Git qui casse en premier

Le discours sur les agents de code n'a pas varié de l'année : ils tournent sans surveillance, donc il faut en lancer plusieurs à la fois. Cinq, dix, plus. Un sur la refonte de l'authentification, un sur le test instable, un sur la migration que personne ne veut toucher.
L'outillage tient à peu près. Puis vous essayez, et ce qui casse, c'est votre répertoire de travail.
Deux agents dans un même checkout s'écrasent mutuellement leurs fichiers en une minute. La solution est dans git depuis 2015 : les worktrees, qui donnent à chaque branche son propre répertoire tout en partageant une seule base d'objets. Git sait le faire. L'interface de git pour le faire est assez mauvaise pour que presque personne ne l'utilise.
Worktrunk est un CLI en Rust qui répare l'interface. Il a 11 900 étoiles, dont environ 2 200 de la semaine passée, et il est sous MIT ou Apache-2.0 selon ce que vous préférez.
Le problème des trois frappes
Créer un worktree dans git demande de taper le nom de branche trois fois :
git worktree add -b feat ../repo.feat cd ../repo.feat
Deux de ces trois sont redondants. Ils existent parce que la commande veut un chemin et une branche, et que le chemin est presque toujours dérivable de la branche. On dirait une petite contrariété. C'est la raison pour laquelle les worktrees sont restés une technique pour gens à opinions tranchées plutôt qu'un défaut.
Worktrunk désigne les worktrees par nom de branche et calcule le chemin à partir d'un modèle configurable. Toute commande qui accepte une branche accepte aussi le chemin du worktree qui la contient. La danse maladroite en trois lignes devient donc :
wt switch -c -x claude feat
Créer une branche, créer son worktree, et lancer Claude dedans, d'où que vous soyez. Le drapeau -x exécute une commande après le basculement. Tout ce que vous ajoutez après un séparateur est transmis à cette commande, et c'est ainsi qu'on donne à l'agent sa première instruction :
wt switch -x claude -c feature-auth
Trois fois cela dans un seul shell et vous avez trois agents sur trois branches, isolés, sans aucune coordination entre eux.
Installation
Homebrew sous macOS ou Linux : brew install worktrunk && wt config shell install. Cargo, pacman, conda-forge et pixi fonctionnent aussi. Sous Windows, c'est winget install max-sixty.worktrunk suivi de git-wt config shell install.
La note Windows mérite d'être répétée parce qu'elle va piéger quelqu'un : wt désigne déjà Windows Terminal, donc Winget installe l'outil sous le nom git-wt pour éviter la collision. Vous pouvez aussi désactiver l'alias Windows Terminal dans les alias d'exécution d'applications et utiliser wt directement.
L'étape config shell install n'est pas facultative. Elle installe le hook de shell qui permet à une commande de changer votre répertoire courant, et c'est tout le mécanisme derrière wt switch. Sautez-la et chaque commande semble ne rien faire.
Les commandes qui comptent
Quatre d'entre elles couvrent l'essentiel du flux de travail.
wt switch vous déplace. wt list affiche chaque worktree avec des marqueurs d'état : @ pour l'endroit où vous êtes, + pour les modifications indexées, ↑1 pour un commit d'avance sur main, ⇡ pour les commits non poussés. Cette sortie seule vaut mieux que git worktree list, qui vous donne des chemins et rien d'autre.
wt remove nettoie, en supprimant le worktree et la branche ensemble, ce qui fait deux commandes dans git et un seul endroit où se tromper.
wt merge main est la plus intéressante. Elle squash la branche courante, la rebase sur main, fait un fast-forward et supprime le worktree, en une étape. Si vous avez déjà résolu trois fois le même conflit sur trois branches parallèles, vous savez pourquoi elle existe. Le parallélisme multiplie le problème de fusion, et le problème de fusion était déjà la partie la moins agréable du travail.
Il y a aussi wt switch pr:123, qui saute directement à la branche derrière une pull request. Petite fonctionnalité, confort disproportionné.
Le stockage, la partie dont personne ne vous prévient
Dix worktrees, c'est dix copies de node_modules et dix copies de target/. Sur un portable, cela fait des centaines de gigaoctets, et le premier cargo build dans chacun prend quatre minutes.
Worktrunk gère cela avec des caches de compilation copy-on-write. Sur les systèmes de fichiers qui le permettent, APFS sur macOS, btrfs et XFS avec reflinks sous Linux, les worktrees partagent le répertoire de compilation et ne divergent que lorsqu'un fichier change. La première compilation paie. Les neuf suivantes empruntent.
C'est le genre de fonctionnalité qui révèle ce que l'auteur fait réellement de l'outil. Personne n'ajoute des caches de compilation partagés à un gestionnaire de worktrees par calcul marketing. On l'ajoute la quatrième fois que son disque s'est rempli.
Le détail associé est hash_port, un filtre de modèle qui donne à chaque worktree un port unique. Dix worktrees, dix serveurs de dev, aucun conflit de port, aucune tenue de registre manuelle. Combinez-le avec un hook post-start qui installe les dépendances et démarre le serveur, et un nouveau worktree est pleinement opérationnel à l'instant où l'agent démarre.
Les hooks sont le côté tranchant
Les hooks exécutent automatiquement des commandes shell à des moments définis : après le démarrage d'un worktree, avant une fusion, après une fusion. Les hooks post-start sont la façon d'obtenir la configuration de l'environnement gratuitement.
Ils sont aussi de l'exécution de code arbitraire déclenchée par une opération git. Un dépôt peut livrer une configuration qui exécute quelque chose sur wt switch, et si vous le clonez puis basculez sur une branche, vous l'avez exécuté. C'est la même classe de risque que npm install lançant un script postinstall, et cela mérite le même traitement : lisez la configuration avant de faire confiance au dépôt.
La réponse de l'outil à cela est que les hooks sont déclarés dans une configuration que vous contrôlez. Savoir si cela suffit dépend de votre modèle de menace, et pour quiconque clone des dépôts inconnus, cela vaut une réflexion.
Ce que ça ne règle pas
Les worktrees partagent un seul répertoire .git, donc ils partagent les références de branches, le stash et la configuration. Deux agents ne peuvent pas checkout la même branche. Un git rebase dans un worktree change l'historique sur lequel un autre worktree est assis. Les entrées de reflog s'entrelacent d'une manière qui complique le travail d'investigation.
Worktrunk rend le cas courant agréable et ne change pas le modèle sous-jacent. Si vos agents ont besoin de dépôts réellement indépendants, il vous faut des clones séparés, et vous perdez le magasin d'objets partagé qui rend les worktrees bon marché au départ.
Il y a aussi un problème de coordination que l'outil ne touche pas. Dix agents sur dix branches produiront dix pull requests qui touchent les mêmes trois fichiers, et aucune gestion de worktrees ne les fera fusionner proprement. Les équipes qui tirent de la valeur du parallélisme semblent être celles qui assignent des zones disjointes, pas celles qui lancent le plus d'agents.
Pourquoi ce genre d'outil attire l'attention
Les frameworks d'agents ont les annonces. Les utilitaires qui rendent les agents utilisables ont les étoiles.
Ce schéma s'est répété toute l'année : couches de mémoire, modes de permission, bacs à sable, gestionnaires de worktrees. Chacun existe parce que le modèle est devenu assez bon pour faire le travail et que l'environnement autour n'a jamais été conçu pour un travailleur qui ne se fatigue pas, ne pose pas de questions, et tournera volontiers quarante minutes dans le mauvais répertoire.
Worktrunk est une réponse petite et ciblée à l'une de ces lacunes. Ses 11 900 étoiles comptent les développeurs qui ont essayé de lancer trois agents à la fois et découvert que le plus dur était le système de fichiers.
Articles associés
Une feuille de calcul communautaire de clics pour couper les publicités des Android chinois
Il ne touche pas au système, ne déverrouille rien, ne flashe rien. Il bascule un à un les interrupteurs que les fabricants ont déjà prévus. Le prix à payer, c'est la liste qu'il faut continuer d'écrire.
GPT Image 2.6 a tenu le prix des tokens et fait monter la facture
GPT Image 2.6 reprend chaque tarif au token de 2.5 et coûte malgré tout plus cher par image, parce qu'une part plus grande du travail se paie en tokens de sortie. Onze jours après le lancement, la grille tarifaire dit plus que le classement.
Quelqu'un a reconstruit IDM de l'extérieur et a écrit ce qu'il n'a pas touché
Une réimplémentation en Rust d'Internet Download Manager revendique 5 fois la vitesse et 86 langues. Le document le plus intéressant est le paragraphe qui explique comment elle a été construite sans rien copier.
Rune est un framework UI Rust conçu pour qu'un agent puisse vérifier son propre travail
Rune rend en headless, vide son arbre d'éléments et accepte des entrées scriptées, ce qui donne à un agent de codage un signal différable qu'aucune capture d'écran ne fournit. Le framework est en préversion et n'accepte pas de pull requests.