Trois agents, un dépôt — et une collision en vue
Exécuter plusieurs agents IA sur un seul checkout Git est une collision qui ne demande qu'à arriver. L'Agent A, au milieu d'une refactorisation, casse soudainement les tests de l'Agent B en raison de dépendances partagées ou de modifications de fichiers contradictoires. Ce problème de dossier partagé paralyse le développement parallèle.
Les Git worktrees offrent une solution immédiate : chaque tâche obtient un répertoire isolé, sa propre branche et un espace de travail propre. Ce second checkout partage l'historique du dépôt, mais les agents n'écrivent plus sur la même feuille de papier. C'est une primitive puissante pour paralléliser le travail.
Cependant, les Git worktrees classiques introduisent leurs propres frictions. En créer un nécessite de taper le nom de la branche trois fois, suivi de changements de répertoire manuels. Le nettoyage nécessite trois commandes supplémentaires pour supprimer le worktree et sa branche.
De plus, demander le statut à Git ne fournit qu'une liste statique de chemins de dossiers. Il n'y a pas de vue unique et dynamique de ce que fait chaque agent, pas de commande de fusion intégrée, et les dépendances restent une préoccupation manuelle. Le support natif des worktrees, comme celui de Claude Code, corrige la création mais laisse subsister ces lacunes critiques.
Le flux de travail en une ligne qui remplace la jonglerie de dossiers
Worktrunk rationalise les flux de travail des agents parallèles en déplaçant l'attention des chemins de dossiers vers les branches. wt switch <branch> crée ou accède à un worktree, éliminant le besoin de taper les noms de branches ou de se souvenir des chemins de répertoires. Cette commande unique configure un environnement isolé pour chaque agent.
wt list fournit un tableau de bord consolidé et interactif. Il affiche chaque worktree actif, montrant sa branche, sa progression par rapport à main, la taille des diffs et des indicateurs d'activité des agents (par exemple, une icône de robot pour les agents actifs, une bulle de dialogue pour les agents en attente d'entrée). Cela remplace les chemins de dossiers statiques de git worktree list par un contexte exploitable.
Lorsqu'un agent termine sa tâche, wt merge automatise un cycle de vie Git complexe en six étapes en une seule commande. Il valide, compresse (squash), rebase sur main, effectue un fast-forward et supprime le worktree terminé ainsi que sa branche. Bien que wt merge automatise la majeure partie du travail fastidieux, les conflits interrompent toujours le rebase, nécessitant une intervention humaine.
L'astuce de vitesse : réutiliser ce dont chaque agent a besoin
L'exécution de plusieurs agents exige une configuration efficace. Worktrunk fournit des hooks de cycle de vie, exécutant automatiquement les tâches de configuration lors de la création d'un worktree. Cela élimine les installations de dépendances répétées et la configuration manuelle de l'environnement, garantissant que chaque agent commence de manière productive.
Worktrunk s'attaque également au stockage et à la vitesse avec wt step copy-ignored. Cette commande réutilise les fichiers ignorés comme node_modules ou les caches de build. Sur les systèmes de fichiers pris en charge (APFS, Btrfs), elle utilise le copy-on-write, en créant des liens vers les fichiers originaux jusqu'à ce que des modifications se produisent. Cela permet d'économiser un espace disque et un temps considérables.
La vidéo démontre des résultats spectaculaires : un dossier de build Rust de 14 Go copié en ~20 secondes avec copy-ignored contre 2 minutes normalement. Un premier build Rust est passé de 68 secondes à 3-4 secondes. Ce sont des temps rapportés par l'auteur, pas des benchmarks universels. Le support du système de fichiers est crucial ; EXT4 sur Linux effectue des copies complètes. De plus, les modules natifs nécessitent toujours une reconstruction. Pour plus de détails sur l'approche de Worktrunk concernant les flux de travail des agents parallèles, consultez Worktrunk — Git worktree management for parallel AI agent workflows.
Cet article vous plaît ? Recevez-en un comme celui-ci chaque matin.
un e-mail par jour · désinscription en deux clics · aucun traqueur tiers
Utile, en évolution rapide — et pas pour tous les développeurs
L'orchestration axée sur le terminal de Worktrunk contraste fortement avec les worktrees natifs de Claude Code. Alors que Claude Code gère l'isolation de base et le nettoyage automatique, il laisse la surveillance du statut et les flux de travail de fusion à l'utilisateur. Worktrunk comble cette lacune en offrant une vue unique de toute l'activité des agents et une fusion en une seule commande qui gère les commits, les squashes, les rebases et la suppression des worktrees.
Ce petit CLI est en version pré-1.0 (actuellement v0.81), ce qui signifie que des changements radicaux sont fréquents ; attendez-vous à mettre à jour votre configuration. Sa configuration de fonction shell pour le changement de répertoire est cruciale, tout comme l'examen des hooks de projet qui exécutent des commandes shell. Les conflits de fusion non résolus nécessitent toujours une intervention manuelle ; Worktrunk arrête le rebase et vous rend le contrôle.
Les avantages du copy-on-write de wt step copy-ignored dépendent du système de fichiers. Sur APFS, c'est presque instantané et permet d'économiser beaucoup d'espace, mais les machines Linux EXT4 effectuent des copies complètes. Les modules natifs devront toujours être reconstruits sur les nouveaux worktrees.
Si vous exécutez un agent à la fois, les worktrees natifs ou Git standard sont probablement suffisants. Cependant, si vous exécutez régulièrement trois, cinq agents ou plus et que vous devez réduire la surcharge des worktrees — de la configuration et l'installation des dépendances aux vérifications de statut et au nettoyage des fusions — Worktrunk fournit la couche d'orchestration manquante.
Questions fréquemment posées
Qu'est-ce que Worktrunk ?
Worktrunk est un CLI open-source qui simplifie la gestion des Git worktrees pour les développeurs exécutant des tâches de codage parallèles ou des agents IA.
Comment Worktrunk aide-t-il avec les agents IA parallèles ?
Il donne à chaque tâche sa propre branche et son propre checkout, affiche le statut des worktrees dans une vue unique et rationalise la fusion et le nettoyage.
Worktrunk fonctionne-t-il uniquement avec Claude Code ?
Non. Il s'intègre avec Claude Code et prend en charge d'autres CLI d'agents, notamment Codex, OpenCode et Gemini CLI.
Worktrunk élimine-t-il les conflits de fusion ?
Non. Les worktrees isolent les fichiers pendant le développement, mais les modifications qui se chevauchent peuvent toujours entrer en conflit lorsqu'elles sont fusionnées.
Worktrunk est-il prêt pour la production ?
Il est en version pré-1.0, attendez-vous donc à d'éventuels changements radicaux et examinez les hooks de projet avant d'approuver leurs commandes shell.