Date: 2026-01-25 (Updated after deep-dive analysis)
Evaluator: Claude (Sonnet 4.5)
Status:
- Worktrunk est un CLI Rust pour simplifier la gestion des git worktrees, créé par max-sixty (créateur de PRQL, 10K stars)
- Réduit la syntaxe de
git worktree add -b feat ../repo.feat && cd ../repo.featàwt switch -c feat - 3 commandes core:
switch,remove,list+ hooks personnalisables + commit messages LLM - GitHub: 1.6K stars, 54 forks, 15 contributeurs, v0.18.2 (Jan 2026), 64 releases actives
- Conçu spécifiquement pour les workflows multi-agents IA (Claude Code mentionné explicitement dans le README)
| Score | Signification |
|---|---|
| 5 | Essentiel - Gap majeur dans le guide |
| 4 | Très pertinent - Amélioration significative |
| 3 | Pertinent - Complément utile |
| 2 | Marginal - Info secondaire |
| 1 | Hors scope - Non pertinent |
Score initial: 2/5 Score révisé après deep-dive: 3/5
Justification révisée:
Points conservés de l'évaluation initiale:
- Le guide couvre déjà exhaustivement les git worktrees (Section 9.17,
/git-worktreecommand) - Worktrunk est un wrapper, pas une fonctionnalité fondamentale
Nouvelles découvertes qui augmentent le score:
- Besoin prouvé: Multiples équipes ont créé des wrappers indépendants:
- incident.io → custom bash wrapper
w(blog post officiel) - Issue #1052 → Fish shell functions complètes
- Worktrunk → Solution Rust mature (1.6K stars)
- incident.io → custom bash wrapper
- Features uniques absentes de git vanilla:
- Project-level hooks pour automation
- LLM-powered commit messages via
llmtool - CI status tracking intégré
- PR link generation
- Path templates configurables
- Adoption significative: 1.6K stars + 64 releases + multi-platform (Homebrew, Cargo, Winget, AUR)
- Pattern validé: Le concept "wrapper worktree" est réinventé indépendamment par plusieurs équipes pro
| Aspect | Worktrunk | Git vanilla + Notre guide | Wrappers custom (incident.io, #1052) |
|---|---|---|---|
| Worktree basics | ✅ Simplifié (wt switch) |
✅ Complet (git worktree add) |
✅ Custom bash/fish functions |
| Safety (.gitignore) | ❌ Non mentionné | ✅ Vérification automatique | |
| DB branching | ❌ Non couvert | ✅ Neon, PlanetScale, local | ❌ Non couvert |
| Hooks setup | ✅ Hooks intégrés | ✅ Auto-detect (Node, Rust, Python, Go) | |
| Cleanup | ✅ wt remove |
✅ Procédure complète + prune | ✅ Custom cleanup functions |
| LLM commits | ✅ Intégré via llm tool |
❌ Hors scope (orthogonal à CC) | ✅ Custom via LLM APIs |
| CI status tracking | ✅ Built-in | ❌ Non couvert | ❌ Non couvert |
| PR link generation | ✅ Built-in | ❌ Non couvert | ❌ Non couvert |
| Multi-agent context | ✅ Conçu pour | ✅ Section 9.17 couvre le workflow | ✅ Oui (incident.io use case) |
| Maintenance | ✅ 64 releases, actif | ✅ Git core (stable) | ❌ Custom code à maintenir |
| Installation | ✅ Multi-platform (Homebrew, Cargo, etc.) | ✅ Git déjà installé | ❌ Copy-paste scripts |
Features validées:
- Path templates configurables (réduit typing répétitif)
- Hooks project-level pour automation
- LLM integration via
llmtool - CI status + PR link generation
- Interactive worktree selection
- Shell integration (change directory capability)
Adoption metrics:
- 1.6K stars, 64 releases, 15+ contributeurs
- Multi-platform: macOS (Homebrew), Linux (Cargo/AUR), Windows (Winget)
- Créateur: max-sixty (PRQL 10K stars, Xarray maintainer)
Découvertes clés:
- ❌ N'utilise PAS Worktrunk - ont créé leur propre wrapper bash
w - ✅ Validation du pattern: Git worktrees résout les "branch management friction"
- ✅ ROI mesuré: 18% improvement (30s) sur API generation time
- ✅ Scale: Multiple Claude instances en parallèle sans contention
- Custom setup:
w myproject new-feature claude→ auto-launch Claude in isolated branch
Citation:
"Rather than constantly switching branches in a single repository, they maintain separate working directories for each feature branch—all connected to the same Git database."
Découvertes critiques:
- ❌ AUCUNE mention de Worktrunk (contrairement à ce que j'avais suggéré initialement)
- ✅ Git worktrees recommandés comme approche officielle Anthropic:
"Git worktrees allow you to check out multiple branches from the same repository into separate directories."
- ✅ 3 approches recommandées:
- Multiple checkouts (3-4 git clones)
- Git worktrees (focus de la recommandation)
- Custom harness + headless mode (
claude -p)
Best practices Anthropic:
- Context isolation via
/clear - Specialized tool separation (coding vs review instances)
- CLAUDE.md inheritance across worktrees
- Conservative permissions approach
Découvertes:
- ❌ N'utilise PAS Worktrunk - workflow Fish shell custom
- ✅ Pattern workflow complet avec 8 functions git custom:
git worktree-llm→ create + start Claudegit worktree-merge→ finish + rebase + mergegit commit-llm→ LLM-generated commitsgit llm-message→ structured diff→commit via LLM
- ✅ Issue status: CLOSED as
NOT_PLANNED(doc sharing, not feature request) - ✅ Author quote: "I now use it for basically all my development where I can use claude code"
Workflow pattern:
git worktree-llm feature-name # Start feature
# ... work with Claude ...
git worktree-merge # Finish, commit, rebase, merge| Équipe | Solution | Langage | Features clés |
|---|---|---|---|
| incident.io | Custom w function |
Bash | Auto-completion, auto-organize ~/projects/worktrees/ |
| Issue #1052 author | Fish functions | Fish shell | LLM commits, rebase automation, cleanup |
| Worktrunk (max-sixty) | CLI mature | Rust | Hooks, CI status, PR links, multi-platform |
Conclusion: Le besoin existe (3 réinventions indépendantes). Worktrunk est la solution la plus mature et feature-rich.
Action: Intégration conditionnelle recommandée
Emplacement: Section 9.17 (Multi-Instance Workflows) ou /git-worktree command
Contenu proposé:
## Advanced Tooling (Optional)
While this guide teaches git worktree fundamentals, several teams have built wrappers for daily productivity:
### Worktrunk (Recommended wrapper)
- **What**: Rust CLI simplifying worktree management (1.6K stars, 64 releases)
- **Why**: Reduces `git worktree add -b feat ../repo.feat && cd ../repo.feat` to `wt switch -c feat`
- **Unique features**: Project hooks, LLM commits, CI status, PR links
- **Install**: `brew install worktrunk` (macOS/Linux) or `cargo install worktrunk`
- **Trade-off**: Learn git fundamentals first, add wrapper for speed later
### DIY Alternative
Teams like incident.io and others built custom bash/fish wrappers. See:
- [incident.io blog](https://incident.io/blog/shipping-faster-with-claude-code-and-git-worktrees)
- [GitHub issue #1052](https://github.com/anthropics/claude-code/issues/1052) (Fish shell functions)
**Philosophy**: Master `git worktree` concepts via this guide, then choose your productivity layer.Emplacement: Fin de /git-worktree command
Contenu minimal:
## See Also
- [Worktrunk](https://github.com/max-sixty/worktrunk) - Productivity wrapper (1.6K stars)
- [incident.io workflow](https://incident.io/blog/shipping-faster-with-claude-code-and-git-worktrees) - Custom bash wrapperScore initial: 2/5 Score après deep-dive: 3/5 ⬆️
Éléments manqués dans l'évaluation initiale:
- Pattern validation: 3 équipes indépendantes ont créé des wrappers (incident.io, issue #1052, Worktrunk) → besoin réel
- Features uniques: CI status, PR links, path templates, project hooks → pas disponibles en git vanilla
- Adoption sous-estimée: 1.6K stars + 64 releases + multi-platform = mature, pas "marginal"
- Use case principal: Daily productivity pour power users, pas "learning tool" (le guide couvre le learning)
Risques de non-intégration mis à jour:
| Risque | Probabilité | Impact | Mitigation recommandée |
|---|---|---|---|
| Users reinvent the wheel | Medium | Medium | Mentionner Worktrunk + DIY alternatives |
| Guide appears pedagogical only | Medium | Low | Ajouter section "Advanced Tooling" |
| Missing productivity gap | High | Medium | Guide enseigne patterns, Worktrunk booste workflow |
| Community expectation mismatch | Low | Low | Pattern validé par Anthropic (worktrees officiels) |
Nouvelles découvertes qui augmentent la pertinence:
- ✅ Anthropic recommande officiellement git worktrees (pas Worktrunk, mais le pattern)
- ✅ incident.io (blog officiel) démontre ROI mesurable (18% improvement)
- ✅ Multiple réinventions indépendantes prouvent le besoin
- ✅ Worktrunk est la solution la plus mature et cross-platform
| Affirmation | Statut | Source | Corrections |
|---|---|---|---|
| 1.6K GitHub stars | ✅ Confirmé | GitHub repo (jan 2026) | - |
| Créé par max-sixty (PRQL author) | ✅ Confirmé | GitHub profile | - |
| v0.18.2 release (Jan 2026) | ✅ Confirmé | GitHub releases | - |
| Mentionné dans Anthropic best practices | ❌ FAUX | anthropic.com/engineering | Correction: Worktrunk n'est PAS mentionné. Seul git worktrees vanilla est recommandé. |
| 64 releases actives | ✅ Confirmé | GitHub releases | Découverte deep-dive |
| Multi-platform (Homebrew, Cargo, Winget, AUR) | ✅ Confirmé | GitHub README | Découverte deep-dive |
| incident.io utilise Worktrunk | ❌ FAUX | incident.io blog | Correction: Ils utilisent un wrapper bash custom w, pas Worktrunk |
| Issue #1052 concerne Worktrunk | ❌ FAUX | GitHub issue #1052 | Correction: Fish shell functions custom, pas Worktrunk |
Corrections majeures apportées:
- ❌ Anthropic best practices ne mentionnent PAS Worktrunk (seul git worktrees vanilla)
- ❌ incident.io n'utilise PAS Worktrunk (custom bash wrapper)
- ❌ Issue #1052 n'est PAS sur Worktrunk (Fish shell workflow)
- ✅ Pattern validé: 3 équipes ont créé des wrappers indépendamment → besoin réel existe
Découvertes additionnelles:
- Git Worktree Toolbox (MCP server, 3 stars) existe mais adoption trop faible
- Le pattern "wrapper worktree" est réinventé systématiquement par les power users
- Anthropic recommande officiellement les worktrees mais reste agnostique sur les wrappers
Score final: 3/5 ⬆️ (pertinent - complément utile)
Action: Intégration conditionnelle recommandée (Option 1: Section "Advanced Tooling")
Confiance: Haute (fact-check approfondi, 4 sources analysées, corrections appliquées)
Raisonnement révisé:
Pour l'intégration:
- Besoin validé: 3 équipes indépendantes ont créé des wrappers (pattern émergent)
- Solution mature: Worktrunk est la plus feature-rich et cross-platform (1.6K stars, 64 releases)
- Gap pédagogique: Guide enseigne fundamentals, users cherchent ensuite productivity boost
- Alignement philosophique: "Learn patterns first, add tools for speed later" (teaching + tooling)
- ROI démontré: incident.io a mesuré 18% improvement avec worktrees
Contre l'intégration:
- ❌ Pas officiellement recommandé par Anthropic (seul vanilla worktrees l'est)
- ✅ Guide couvre déjà exhaustivement les patterns git worktree
- ✅ Philosophie "patterns > tools" doit rester prioritaire
Compromis optimal: Section "Advanced Tooling" qui:
- Enseigne d'abord les patterns git worktree (priority #1)
- Mentionne ensuite les wrappers mature (Worktrunk) + DIY alternatives
- Préserve la philosophie "learn fundamentals first"
- Offre un choix éclairé aux power users
Changes proposés: Ajout section "Advanced Tooling (Optional)"
Files à modifier:
- Fichier:
guide/ultimate-guide.md - Ligne: ~10700 (après "Database Branch Workflow")
- Contenu: Section complète "Advanced Tooling" (voir Option 1 ci-dessus)
- Impact: ~15 lignes ajoutées
- Fichier:
examples/commands/git-worktree.md - Ligne: ~210 (fin du document)
- Contenu: Section "See Also" minimale (voir Option 2 ci-dessus)
- Impact: ~3 lignes ajoutées
Recommandation finale: Option A (Section 9.17) car:
- Plus contextualisée (workflows multi-instance = use case principal)
- Permet d'expliquer le pattern "learn fundamentals → add productivity layer"
- Cohérent avec la découverte "3 équipes ont réinventé des wrappers"
- N'impacte pas la pédagogie du
/git-worktreecommand (reste fundamentals-focused)
Prochaines étapes:
- Validation user de l'approche (Option A vs Option B vs ignorer)
- Rédaction du contenu final
- Update de
machine-readable/reference.yamlsi Section 9.17 modifiée - Commit:
docs: add advanced worktree tooling section (Worktrunk + DIY alternatives)