Skip to content

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

Refactor documentation for clarity and simplicity

Maximilian Roose1776775a65e
diff --git a/README.md b/README.md
index 2ac856bfa..8b023a0de 100644
--- a/README.md
+++ b/README.md
@@ -14,9 +14,11 @@
> **December 2025**: I've been using Worktrunk as my daily driver, and am releasing it as Open Source this week; I think folks will find it really helpful. It's built with love (there's no slop!). If social proof is helpful: I also created [PRQL](https://github.com/PRQL/prql) (10k stars) and am a maintainer of [Xarray](https://github.com/pydata/xarray) (4k stars), [Insta](https://github.com/mitsuhiko/insta), & [Numbagg](https://github.com/numbagg/numbagg).
-Worktrunk is a CLI for git worktree management, designed for parallel AI agent workflows. Git worktrees give each agent an isolated branch and directory; Worktrunk wraps them in a clean interface, plus extension points. Scaling agents becomes as simple as scaling git branches.
+Worktrunk is a CLI for git worktree management, designed for running AI agents in parallel.
-Here's a quick demo:
+Worktrunk's three core commands make worktrees as easy as branches. Plus, Worktrunk has a bunch of quality-of-life features to simplify working with many parallel changes, including hooks to automate local workflows.
+
+Scaling agents becomes trivial. Here's a quick demo:
![Worktrunk Demo](https://cdn.jsdelivr.net/gh/max-sixty/worktrunk-assets@main/demos/wt-core.gif)
@@ -81,7 +83,7 @@ git branch -d feat</pre></td>
> Expand into the more advanced commands as needed
-- **[Lifecycle hooks](https://worktrunk.dev/hook/)** — run commands on create, pre-merge, post-merge
+- **[Hooks](https://worktrunk.dev/hook/)** — run commands on create, pre-merge, post-merge, etc
- **[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](#next-steps)**
diff --git a/docs/content/worktrunk.md b/docs/content/worktrunk.md
index 1ff9c4f60..947de3004 100644
--- a/docs/content/worktrunk.md
+++ b/docs/content/worktrunk.md
@@ -6,20 +6,18 @@ weight = 1
Worktrunk is a CLI for git worktree management, designed for running AI agents
in parallel.
-Worktrunk's three core commands make worktrees as easy to use as branches.
-Additionally, Worktrunk has lots quality-of-life features to simplify working
+Worktrunk's three core commands make worktrees as easy as branches.
+Plus, Worktrunk has a bunch of quality-of-life features to simplify working
with many parallel changes, including hooks to automate local workflows.
-Scaling agents becomes trivial.
-
-Here's a quick demo:
+Scaling agents becomes trivial. Here's a quick demo:
<figure class="demo">
<picture>
<source srcset="/assets/wt-core-dark.gif" media="(prefers-color-scheme: dark)">
<img src="/assets/wt-core.gif" alt="Worktrunk demo showing wt list, wt switch, and hooks" width="1600" height="900">
</picture>
-<figcaption>Listing worktrees, switching, and hooks in action</figcaption>
+<figcaption>Listing worktrees, switching, cleaning up</figcaption>
</figure>
## Context: git worktrees
@@ -79,7 +77,7 @@ git branch -d feat{% end %}</td>
> Expand into the more advanced commands as needed
-- **[Lifecycle hooks](@/hook.md)** — run commands on create, pre-merge, post-merge
+- **[Hooks](@/hook.md)** — run commands on create, pre-merge, post-merge, etc
- **[LLM commit messages](@/llm-commits.md)** — generate commit messages from diffs via [llm](https://llm.datasette.io/)
- **[Merge workflow](@/merge.md)** — squash, rebase, merge, clean up in one command
- ...and **[lots more](#next-steps)**