Skip to content

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

docs(homepage): add headline features and tips link (#1501)

Maximilian Roosa892caa39bdc
diff --git a/README.md b/README.md
index f353b407a..b1abb431d 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,9 @@ git branch -d feat</pre></td>
- **[Merge workflow](https://worktrunk.dev/merge/)** — squash, rebase, merge, clean up in one command
- **[Interactive picker](https://worktrunk.dev/switch/#interactive-picker)** — browse worktrees with live diff and log previews
- **[Copy build caches](https://worktrunk.dev/step/)** — skip cold starts by sharing `target/`, `node_modules/`, etc between worktrees
+- **[`wt list --full`](https://worktrunk.dev/list/#full-mode)** — [CI status](https://worktrunk.dev/list/#ci-status) and [AI-generated summaries](https://worktrunk.dev/list/#llm-summaries-experimental) per branch
+- **[PR checkout](https://worktrunk.dev/switch/#github-pull-requests)** — `wt switch pr:123` to jump straight to a PR's branch
+- **[Dev server per worktree](https://worktrunk.dev/hook/#dev-servers)** — `hash_port` template filter gives each worktree a unique port
- ...and **[lots more](#next-steps)**
A demo with some advanced features:
@@ -202,6 +205,7 @@ The `-x` flag runs a command after switching; arguments after `--` are passed to
- Explore [LLM commit messages](https://worktrunk.dev/llm-commits/), [interactive
picker](https://worktrunk.dev/switch/#interactive-picker), [Claude Code integration](https://worktrunk.dev/claude-code/), [CI
status & PR links](https://worktrunk.dev/list/#ci-status)
+- Browse [tips & patterns](https://worktrunk.dev/tips-patterns/) for recipes: aliases, dev servers, databases, agent handoffs, and more
- Run `wt --help` or `wt <command> --help` for quick CLI reference
## Further reading
diff --git a/docs/content/list.md b/docs/content/list.md
index 675bcd35f..ff5d82b59 100644
--- a/docs/content/list.md
+++ b/docs/content/list.md
@@ -20,7 +20,11 @@ Shows uncommitted changes, divergence from the default branch and remote, and op
</picture>
</figure>
-The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete. With `--full`, CI status fetches from the network and LLM summaries are generated — the table displays instantly and columns fill in as results arrive.
+The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete.
+
+## Full mode
+
+`--full` adds columns that require network access or LLM calls: [CI status](#ci-status) (GitHub/GitLab pipeline pass/fail), line diffs since the merge-base, and [LLM-generated summaries](#llm-summaries-experimental) of each branch's changes. The table displays instantly and columns fill in as results arrive.
## Examples
diff --git a/docs/content/worktrunk.md b/docs/content/worktrunk.md
index 5ff188da4..3ff717731 100644
--- a/docs/content/worktrunk.md
+++ b/docs/content/worktrunk.md
@@ -88,6 +88,9 @@ git branch -d feat{% end %}</td>
- **[Merge workflow](@/merge.md)** — squash, rebase, merge, clean up in one command
- **[Interactive picker](@/switch.md#interactive-picker)** — browse worktrees with live diff and log previews
- **[Copy build caches](@/step.md)** — skip cold starts by sharing `target/`, `node_modules/`, etc between worktrees
+- **[`wt list --full`](@/list.md#full-mode)** — [CI status](@/list.md#ci-status) and [AI-generated summaries](@/list.md#llm-summaries-experimental) per branch
+- **[PR checkout](@/switch.md#github-pull-requests)** — `wt switch pr:123` to jump straight to a PR's branch
+- **[Dev server per worktree](@/hook.md#dev-servers)** — `hash_port` template filter gives each worktree a unique port
- ...and **[lots more](#next-steps)**
A demo with some advanced features:
@@ -214,6 +217,7 @@ The `-x` flag runs a command after switching; arguments after `--` are passed to
- Explore [LLM commit messages](@/llm-commits.md), [interactive
picker](@/switch.md#interactive-picker), [Claude Code integration](@/claude-code.md), [CI
status & PR links](@/list.md#ci-status)
+- Browse [tips & patterns](@/tips-patterns.md) for recipes: aliases, dev servers, databases, agent handoffs, and more
- Run `wt --help` or `wt <command> --help` for quick CLI reference
## Further reading
diff --git a/skills/worktrunk/reference/list.md b/skills/worktrunk/reference/list.md
index 8d37e5627..f97128dad 100644
--- a/skills/worktrunk/reference/list.md
+++ b/skills/worktrunk/reference/list.md
@@ -4,7 +4,11 @@ List worktrees and their status.
Shows uncommitted changes, divergence from the default branch and remote, and optional CI status and LLM summaries.
-The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete. With `--full`, CI status fetches from the network and LLM summaries are generated — the table displays instantly and columns fill in as results arrive.
+The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete.
+
+## Full mode
+
+`--full` adds columns that require network access or LLM calls: [CI status](#ci-status) (GitHub/GitLab pipeline pass/fail), line diffs since the merge-base, and [LLM-generated summaries](#llm-summaries-experimental) of each branch's changes. The table displays instantly and columns fill in as results arrive.
## Examples
diff --git a/skills/worktrunk/reference/worktrunk.md b/skills/worktrunk/reference/worktrunk.md
index b7e174348..afa747ac4 100644
--- a/skills/worktrunk/reference/worktrunk.md
+++ b/skills/worktrunk/reference/worktrunk.md
@@ -73,6 +73,9 @@ git branch -d feat{% end %}</td>
- **[Merge workflow](https://worktrunk.dev/merge/)** — squash, rebase, merge, clean up in one command
- **[Interactive picker](https://worktrunk.dev/switch/#interactive-picker)** — browse worktrees with live diff and log previews
- **[Copy build caches](https://worktrunk.dev/step/)** — skip cold starts by sharing `target/`, `node_modules/`, etc between worktrees
+- **[`wt list --full`](https://worktrunk.dev/list/#full-mode)** — [CI status](https://worktrunk.dev/list/#ci-status) and [AI-generated summaries](https://worktrunk.dev/list/#llm-summaries-experimental) per branch
+- **[PR checkout](https://worktrunk.dev/switch/#github-pull-requests)** — `wt switch pr:123` to jump straight to a PR's branch
+- **[Dev server per worktree](https://worktrunk.dev/hook/#dev-servers)** — `hash_port` template filter gives each worktree a unique port
- ...and **[lots more](#next-steps)**
A demo with some advanced features:
@@ -179,6 +182,7 @@ The `-x` flag runs a command after switching; arguments after `--` are passed to
- Explore [LLM commit messages](https://worktrunk.dev/llm-commits/), [interactive
picker](https://worktrunk.dev/switch/#interactive-picker), [Claude Code integration](https://worktrunk.dev/claude-code/), [CI
status & PR links](https://worktrunk.dev/list/#ci-status)
+- Browse [tips & patterns](https://worktrunk.dev/tips-patterns/) for recipes: aliases, dev servers, databases, agent handoffs, and more
- Run `wt --help` or `wt <command> --help` for quick CLI reference
## Further reading
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index a482ad2f5..e3036f05a 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -474,7 +474,11 @@ To change which branch a worktree is on, use `git switch` inside that worktree.
after_long_help = r#"Shows uncommitted changes, divergence from the default branch and remote, and optional CI status and LLM summaries.
<!-- demo: wt-list.gif 1600x900 -->
-The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete. With `--full`, CI status fetches from the network and LLM summaries are generated — the table displays instantly and columns fill in as results arrive.
+The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete.
+
+## Full mode
+
+`--full` adds columns that require network access or LLM calls: [CI status](#ci-status) (GitHub/GitLab pipeline pass/fail), line diffs since the merge-base, and [LLM-generated summaries](#llm-summaries-experimental) of each branch's changes. The table displays instantly and columns fill in as results arrive.
## Examples
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 8681a5051..4e15b560d 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
@@ -74,7 +74,11 @@ Usage: wt list [OPTIONS]
Shows uncommitted changes, divergence from the default branch and remote, and optional CI status and LLM summaries.
-The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete. With --full, CI status fetches from the network and LLM summaries are generated — the table displays instantly and columns fill in as results arrive.
+The table renders progressively: branch names, paths, and commit hashes appear immediately, then status, divergence, and other columns fill in as background git operations complete.
+
+Full mode
+
+--full adds columns that require network access or LLM calls: CI status (GitHub/GitLab pipeline pass/fail), line diffs since the merge-base, and LLM-generated summaries of each branch's changes. The table displays instantly and columns fill in as results arrive.
Examples
diff --git a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
index 8bb0f0341..481f84150 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap
@@ -79,9 +79,14 @@ optional CI status and LLM summaries.
The table renders progressively: branch names, paths, and commit hashes appear
immediately, then status, divergence, and other columns fill in as background
-git operations complete. With --full, CI status fetches from the network and LLM
- summaries are generated — the table displays instantly and columns fill in as
-results arrive.
+git operations complete.
+
+Full mode
+
+--full adds columns that require network access or LLM calls: CI status
+(GitHub/GitLab pipeline pass/fail), line diffs since the merge-base, and
+LLM-generated summaries of each branch's changes. The table displays instantly
+and columns fill in as results arrive.
Examples