Skip to content

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.md
index 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.md
index 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.toml
worktree-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.md
index 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 symbols
diff --git a/docs/content/claude-code.md b/docs/content/claude-code.md
index 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.md
index 2554ab16f..2959942dd 100644
--- a/docs/content/config.md
+++ b/docs/content/config.md
@@ -49,9 +49,8 @@ wt config show
# ~/.config/worktrunk/config.toml
worktree-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.md
index 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 symbols
diff --git a/docs/demos/build b/docs/demos/build
index 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.rs
index 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.toml
worktree-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.snap
index 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:
# ~/.config/worktrunk/config.toml
worktree-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_list_long.snap b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
index 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: C
RUST_LOG: warn
SHELL: ""
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 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
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 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: C
RUST_LOG: warn
SHELL: ""
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 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.
+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