Skip to content

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

docs: refine why-worktrunk messaging for clarity

Maximilian Roosd078f796c986
diff --git a/docs/content/why-worktrunk.md b/docs/content/why-worktrunk.md
index 44e2450a6..a0191f4ed 100644
--- a/docs/content/why-worktrunk.md
+++ b/docs/content/why-worktrunk.md
@@ -11,13 +11,13 @@ Worktrunk is a CLI for git worktree management, designed for parallel AI agent w
AI agents like Claude and Codex can increasingly handle longer tasks without supervision. Running several in parallel is practical. But on a single checkout they step on each other's uncommitted changes.
-Git worktrees solve this: multiple working directories backed by one `.git`. Each gets its own files and index but shares the repository's history and objects.
+Git worktrees solve this: multiple working directories backed by one `.git`. Each gets its own files and index while sharing the repository's history and objects.
But the built-in commands are path-oriented: `git worktree add ../repo.feature`, then `cd ../repo.feature`, then later `git worktree remove ../repo.feature`.
## What Worktrunk adds
-Worktrunk makes worktrees easy to use. Branch names replace paths:
+Worktrunk makes worktrees easy to use. Both for branch-based navigation & status....
| Task | Worktrunk | Plain git |
|------|-----------|-----------|
@@ -26,7 +26,7 @@ Worktrunk makes worktrees easy to use. Branch names replace paths:
| Clean up | `wt remove` | `cd ../repo && git worktree remove ../repo.feature && git branch -d feature` |
| List with status | `wt list` | `git worktree list` (paths only) |
-Beyond navigation, Worktrunk automates common tasks:
+...and automating a bunch of workflows:
- **[Lifecycle hooks](@/hooks.md)** — run commands on create, switch, merge (deps install, dev servers, test suites)
- **[LLM commit messages](@/llm-commits.md)** — generate commits from diffs via [llm](https://llm.datasette.io/)