Skip to content

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

Update README and help text for clarity

Maximilian Roos278204ce8e40
diff --git a/README.md b/README.md
index 2f19d9616..0c054f294 100644
--- a/README.md
+++ b/README.md
@@ -21,21 +21,21 @@ Here's a quick demo:
> ## πŸ“š Full documentation at [worktrunk.dev](https://worktrunk.dev) πŸ“š
-<!-- ⚠️ AUTO-GENERATED from docs/content/why-worktrunk.md#context-git-worktrees..what-worktrunk-adds β€” edit source to update -->
+<!-- ⚠️ AUTO-GENERATED from docs/content/why-worktrunk.md#git-worktrees-are-a-great-primitive..worktrunk-makes-git-worktrees-easy β€” edit source to update -->
-## Context: git worktrees
+## Git worktrees are a great primitive
AI agents like Claude Code and Codex can increasingly handle longer tasks
without supervision, and it's very practical to run several in parallel. Git
worktrees provide each agent with its own working directory, avoiding agents
stepping on each other's changes.
-But the git worktree UX is clunky. Even something as simple as "start a new worktree" is complicated:
+But the git worktree UX is clunky. Even something as simple as "start a new worktree" is verbose:
`git worktree add -b feature ../repo.feature`, then `cd ../repo.feature`.
-## What Worktrunk adds
+## Worktrunk makes git worktrees easy
-Worktrunk makes worktrees easy to use β€” branch-based navigation, unified status, and workflow automation.
+Worktrunk makes git worktrees easy to use β€” branch-based navigation, unified status, and workflow automation.
**Core commands:**
@@ -51,7 +51,7 @@ Worktrunk makes worktrees easy to use β€” branch-based navigation, unified statu
- **[Lifecycle hooks](https://worktrunk.dev/hook/)** β€” run commands on create, pre-merge, post-merge
- **[LLM commit messages](https://worktrunk.dev/llm-commits/)** β€” generate commit messages from diffs via [llm](https://llm.datasette.io/)
- **[Merge workflow](https://worktrunk.dev/merge/)** β€” squash, rebase, merge, clean up in one command
-- ...and lots more.
+- ...and [lots more](https://worktrunk.dev/#next-steps)
<!-- END AUTO-GENERATED -->
diff --git a/tests/snapshots/integration__integration_tests__help__help_list_long.snap b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
index 112e9972f..9959cda50 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
@@ -95,6 +95,8 @@ Output as JSON for scripting:
Age Time since last commit
Message Last commit message (truncated)
+CI status
+
The CI column shows GitHub/GitLab pipeline status:
Indicator Meaning