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.mdindex 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/), [interactivepicker](https://worktrunk.dev/switch/#interactive-picker), [Claude Code integration](https://worktrunk.dev/claude-code/), [CIstatus & 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 readingdiff --git a/docs/content/list.md b/docs/content/list.mdindex 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.## Examplesdiff --git a/docs/content/worktrunk.md b/docs/content/worktrunk.mdindex 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), [interactivepicker](@/switch.md#interactive-picker), [Claude Code integration](@/claude-code.md), [CIstatus & 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 readingdiff --git a/skills/worktrunk/reference/list.md b/skills/worktrunk/reference/list.mdindex 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.## Examplesdiff --git a/skills/worktrunk/reference/worktrunk.md b/skills/worktrunk/reference/worktrunk.mdindex 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/), [interactivepicker](https://worktrunk.dev/switch/#interactive-picker), [Claude Code integration](https://worktrunk.dev/claude-code/), [CIstatus & 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 readingdiff --git a/src/cli/mod.rs b/src/cli/mod.rsindex 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.## Examplesdiff --git a/tests/snapshots/integration__integration_tests__help__help_list_long.snap b/tests/snapshots/integration__integration_tests__help__help_list_long.snapindex 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: [1m[36mwt list[0m [36m[OPTIONS][0mShows 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 [2m--full[0m, 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.++[1m[32mFull mode[0m++[2m--full[0m 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.[1m[32mExamples[0mdiff --git a/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snap b/tests/snapshots/integration__integration_tests__help__help_list_narrow_80.snapindex 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 appearimmediately, then status, divergence, and other columns fill in as background-git operations complete. With [2m--full[0m, 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.++[1m[32mFull mode[0m++[2m--full[0m 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.[1m[32mExamples[0m