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.mdindex 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:@@ -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.mdindex 1ff9c4f60..947de3004 100644--- a/docs/content/worktrunk.md+++ b/docs/content/worktrunk.md@@ -6,20 +6,18 @@ weight = 1Worktrunk is a CLI for git worktree management, designed for running AI agentsin 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 workingwith 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)**