Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows
docs: Update stale documentation since v0.18.2 (#853)
Maximilian Roos632c6ca28ac6
diff --git a/.claude-plugin/skills/worktrunk/reference/claude-code.md b/.claude-plugin/skills/worktrunk/reference/claude-code.mdindex be5683759..8b5c2e8f2 100644--- a/.claude-plugin/skills/worktrunk/reference/claude-code.md+++ b/.claude-plugin/skills/worktrunk/reference/claude-code.md@@ -53,7 +53,9 @@ $ git config worktrunk.state.feature.marker '{"marker":"π¬","set_at":0}' # Di`wt list statusline --claude-code` outputs a single-line status for the Claude Code statusline. This may fetch CI status from the network when the cache is stale (often ~1β2 seconds), making it suitable for async statuslines but too slow for synchronous shell prompts. If a faster version would be helpful, please [open an issue](https://github.com/max-sixty/worktrunk/issues).-<code>~/w/myproject.feature-auth !π€ @<span style='color:#0a0'>+42</span> <span style='color:#a00'>-8</span> <span style='color:#0a0'>β3</span> <span style='color:#0a0'>β‘1</span> <span style='color:#0a0'>β</span> | Opus</code>+<code>~/w/myproject.feature-auth !π€ @<span style='color:#0a0'>+42</span> <span style='color:#a00'>-8</span> <span style='color:#0a0'>β3</span> <span style='color:#0a0'>β‘1</span> <span style='color:#0a0'>β</span> | Opus π 65%</code>++When Claude Code provides context window usage via stdin JSON, a moon phase gauge appears (πβπ as context fills).Add to `~/.claude/settings.json`:diff --git a/.claude-plugin/skills/worktrunk/reference/config.md b/.claude-plugin/skills/worktrunk/reference/config.mdindex 7fe68d529..0f63c0dc4 100644--- a/.claude-plugin/skills/worktrunk/reference/config.md+++ b/.claude-plugin/skills/worktrunk/reference/config.md@@ -41,9 +41,8 @@ wt config show# ~/.config/worktrunk/config.tomlworktree-path = ".worktrees/{{ branch | sanitize }}"-[commit-generation]-command = "llm"-args = ["-m", "claude-haiku-4.5"]+[commit.generation]+command = "llm -m claude-haiku-4.5"```**Project config** β shared team settings:diff --git a/.claude-plugin/skills/worktrunk/reference/list.md b/.claude-plugin/skills/worktrunk/reference/list.mdindex 314a2db43..ade6c92ab 100644--- a/.claude-plugin/skills/worktrunk/reference/list.md+++ b/.claude-plugin/skills/worktrunk/reference/list.md@@ -79,7 +79,7 @@ The CI column shows GitHub/GitLab pipeline status:| <span style='color:#a60'>β </span> yellow | Fetch error (rate limit, network) || (blank) | No upstream or no PR/MR |-CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank. Results are cached for 30-60 seconds; use `wt config state` to view or clear.+CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank; remote-only branches (visible with `--remotes`) get CI status detection. Results are cached for 30-60 seconds; use `wt config state` to view or clear.## Status symbolsdiff --git a/docs/content/claude-code.md b/docs/content/claude-code.mdindex 2863bae99..3acc73274 100644--- a/docs/content/claude-code.md+++ b/docs/content/claude-code.md@@ -65,7 +65,9 @@ $ git config worktrunk.state.feature.marker '{"marker":"π¬","set_at":0}' # Di`wt list statusline --claude-code` outputs a single-line status for the Claude Code statusline. This may fetch CI status from the network when the cache is stale (often ~1β2 seconds), making it suitable for async statuslines but too slow for synchronous shell prompts. If a faster version would be helpful, please [open an issue](https://github.com/max-sixty/worktrunk/issues).-<code>~/w/myproject.feature-auth !π€ @<span style='color:#0a0'>+42</span> <span style='color:#a00'>-8</span> <span style='color:#0a0'>β3</span> <span style='color:#0a0'>β‘1</span> <span style='color:#0a0'>β</span> | Opus</code>+<code>~/w/myproject.feature-auth !π€ @<span style='color:#0a0'>+42</span> <span style='color:#a00'>-8</span> <span style='color:#0a0'>β3</span> <span style='color:#0a0'>β‘1</span> <span style='color:#0a0'>β</span> | Opus π 65%</code>++When Claude Code provides context window usage via stdin JSON, a moon phase gauge appears (πβπ as context fills).<figure class="demo"><picture>diff --git a/docs/content/config.md b/docs/content/config.mdindex 2554ab16f..2959942dd 100644--- a/docs/content/config.md+++ b/docs/content/config.md@@ -49,9 +49,8 @@ wt config show# ~/.config/worktrunk/config.tomlworktree-path = ".worktrees/{{ branch | sanitize }}"-[commit-generation]-command = "llm"-args = ["-m", "claude-haiku-4.5"]+[commit.generation]+command = "llm -m claude-haiku-4.5"```**Project config** β shared team settings:diff --git a/docs/content/list.md b/docs/content/list.mdindex 3c9aab74b..5b37dc37d 100644--- a/docs/content/list.md+++ b/docs/content/list.md@@ -111,7 +111,7 @@ The CI column shows GitHub/GitLab pipeline status:| <span style='color:#a60'>β </span> yellow | Fetch error (rate limit, network) || (blank) | No upstream or no PR/MR |-CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank. Results are cached for 30-60 seconds; use `wt config state` to view or clear.+CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank; remote-only branches (visible with `--remotes`) get CI status detection. Results are cached for 30-60 seconds; use `wt config state` to view or clear.## Status symbolsdiff --git a/docs/demos/build b/docs/demos/buildindex f12eda8bf..8e88cd446 100755--- a/docs/demos/build+++ b/docs/demos/build@@ -83,9 +83,8 @@ def _write_user_config(content = ""if commit_generation:- content += """[commit-generation]-command = "llm"-args = ["-m", "claude-haiku-4.5"]+ content += """[commit.generation]+command = "llm -m claude-haiku-4.5""""content += f'[projects."{project_id}"]\n'diff --git a/src/cli/mod.rs b/src/cli/mod.rsindex 0a5690fa2..44ae4739d 100644--- a/src/cli/mod.rs+++ b/src/cli/mod.rs@@ -477,7 +477,7 @@ The CI column shows GitHub/GitLab pipeline status:| `β ` yellow | Fetch error (rate limit, network) || (blank) | No upstream or no PR/MR |-CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank. Results are cached for 30-60 seconds; use `wt config state` to view or clear.+CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank; remote-only branches (visible with `--remotes`) get CI status detection. Results are cached for 30-60 seconds; use `wt config state` to view or clear.## Status symbols@@ -1489,9 +1489,8 @@ wt config show# ~/.config/worktrunk/config.tomlworktree-path = ".worktrees/{{ branch | sanitize }}"-[commit-generation]-command = "llm"-args = ["-m", "claude-haiku-4.5"]+[commit.generation]+command = "llm -m claude-haiku-4.5"```**Project config** β shared team settings:diff --git a/tests/snapshots/integration__integration_tests__help__help_config_long.snap b/tests/snapshots/integration__integration_tests__help__help_config_long.snapindex ac7fcf669..23486b37e 100644--- a/tests/snapshots/integration__integration_tests__help__help_config_long.snap+++ b/tests/snapshots/integration__integration_tests__help__help_config_long.snap@@ -80,9 +80,8 @@ Show current configuration and file locations:[2m# ~/.config/worktrunk/config.toml[0m[2mworktree-path = ".worktrees/{{ branch | sanitize }}"[0m[2m[0m- [2m[commit-generation][0m- [2mcommand = "llm"[0m- [2margs = ["-m", "claude-haiku-4.5"][0m+ [2m[commit.generation][0m+ [2mcommand = "llm -m claude-haiku-4.5"[0m[1mProject config[0m β shared team settings:diff --git a/tests/snapshots/integration__integration_tests__help__help_list_long.snap b/tests/snapshots/integration__integration_tests__help__help_list_long.snapindex fa3476c22..b93deaaae 100644--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap@@ -9,6 +9,8 @@ info:CLICOLOR_FORCE: "1"COLUMNS: "500"GIT_EDITOR: ""+ LANG: C+ LC_ALL: CRUST_LOG: warnSHELL: ""TERM: alacritty@@ -118,7 +120,7 @@ The CI column shows GitHub/GitLab pipeline status:β yellow Fetch error (rate limit, network)(blank) No upstream or no PR/MR-CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank. Results are cached for 30-60 seconds; use [2mwt config state[0m to view or clear.+CI indicators are clickable links to the PR or pipeline page. Any CI dot appears dimmed when there are unpushed local changes (stale status). PRs/MRs are checked first, then branch workflows/pipelines for branches with an upstream. Local-only branches show blank; remote-only branches (visible with [2m--remotes[0m) get CI status detection. Results are cached for 30-60 seconds; use [2mwt config state[0m to view or clear.[1m[32mStatus symbols[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 993238c62..26b6756c3 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@@ -9,6 +9,8 @@ info:CLICOLOR_FORCE: "1"COLUMNS: "80"GIT_EDITOR: ""+ LANG: C+ LC_ALL: CRUST_LOG: warnSHELL: ""TERM: alacritty@@ -127,8 +129,9 @@ The CI column shows GitHub/GitLab pipeline status:CI indicators are clickable links to the PR or pipeline page. Any CI dot appearsdimmed when there are unpushed local changes (stale status). PRs/MRs arechecked first, then branch workflows/pipelines for branches with an upstream.-Local-only branches show blank. Results are cached for 30-60 seconds; use [2mwt-[2mconfig state[0m to view or clear.+Local-only branches show blank; remote-only branches (visible with [2m--remotes[0m)+get CI status detection. Results are cached for 30-60 seconds; use [2mwt config+[2mstate[0m to view or clear.[1m[32mStatus symbols[0m