Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Clarify git worktrees section with improved wording

Maximilian Roos8bc4c8ffe716
diff --git a/README.md b/README.md
index bf52799ac..587a860b5 100644
--- a/README.md
+++ b/README.md
@@ -19,11 +19,11 @@ Worktrunk is a CLI for git worktree management, designed for parallel AI agent w
> ## πŸ“š Full documentation at [worktrunk.dev](https://worktrunk.dev) πŸ“š
-## Git worktrees
+## Context: git worktrees
AI agents like Claude and Codex can increasingly handle longer tasks without supervision, and it's very practical to run several in parallel. But on a single file tree they step on each other's uncommitted changes.
-Git worktrees solve this: multiple working directories sharing one `.git`.
+Git worktrees are a great primitive for this: multiple working directories sharing one `.git`.
But git worktrees' UX is clunky: `git worktree add -b feature ../repo.feature`, then `cd ../repo.feature`, then `git worktree remove ../repo.feature`.