Skip to content

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

Simplify config state help text

Maximilian Roosce375d6c57cf
diff --git a/.claude-plugin/skills/worktrunk/reference/config.md b/.claude-plugin/skills/worktrunk/reference/config.md
index ba9ebbe3c..d6bb859d2 100644
--- a/.claude-plugin/skills/worktrunk/reference/config.md
+++ b/.claude-plugin/skills/worktrunk/reference/config.md
@@ -818,13 +818,7 @@ Caches GitHub/GitLab CI status for display in [`wt list`](https://worktrunk.dev/
See [`wt list` CI status](https://worktrunk.dev/list/#ci-status) for display symbols and colors.
-### When to use
-
-- **Debug** — See cached status and when it was fetched
-- **Refresh** — Force re-fetch with `get --refresh`
-- **Clear** — Remove stale cache entries
-
-Without a subcommand, runs `get` for the current branch. For `--branch` or `--refresh`, use `get --branch=NAME`.
+Without a subcommand, runs `get` for the current branch. Use `get --refresh` to force re-fetch or `clear --all` to reset cache.
### Command reference
diff --git a/docs/content/config.md b/docs/content/config.md
index 30dea7f75..8941cd9fc 100644
--- a/docs/content/config.md
+++ b/docs/content/config.md
@@ -839,13 +839,7 @@ Caches GitHub/GitLab CI status for display in [`wt list`](@/list.md#ci-status).
See [`wt list` CI status](@/list.md#ci-status) for display symbols and colors.
-### When to use
-
-- **Debug** — See cached status and when it was fetched
-- **Refresh** — Force re-fetch with `get --refresh`
-- **Clear** — Remove stale cache entries
-
-Without a subcommand, runs `get` for the current branch. For `--branch` or `--refresh`, use `get --branch=NAME`.
+Without a subcommand, runs `get` for the current branch. Use `get --refresh` to force re-fetch or `clear --all` to reset cache.
### Command reference
diff --git a/src/cli/config.rs b/src/cli/config.rs
index eea4d64a9..6809e131a 100644
--- a/src/cli/config.rs
+++ b/src/cli/config.rs
@@ -312,16 +312,7 @@ The local inference fallback uses these heuristics in order:
Updated automatically on every `wt switch`. Stored in git config as `worktrunk.history`.
-## When to use
-
-Most users never need this command — the previous branch updates automatically.
-Use it to:
-
-- **Debug** — See what `-` resolves to
-- **Override** — Set a specific branch as "previous"
-- **Clear** — Reset the history
-
-Without a subcommand, runs `get`."#
+Without a subcommand, runs `get`. Use `set` to override or `clear` to reset."#
)]
PreviousBranch {
#[command(subcommand)]
@@ -353,13 +344,7 @@ Without a subcommand, runs `get`."#
See [`wt list` CI status](@/list.md#ci-status) for display symbols and colors.
-## When to use
-
-- **Debug** — See cached status and when it was fetched
-- **Refresh** — Force re-fetch with `get --refresh`
-- **Clear** — Remove stale cache entries
-
-Without a subcommand, runs `get` for the current branch. For `--branch` or `--refresh`, use `get --branch=NAME`."#
+Without a subcommand, runs `get` for the current branch. Use `get --refresh` to force re-fetch or `clear --all` to reset cache."#
)]
CiStatus {
#[command(subcommand)]
diff --git a/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap b/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap
index 326449705..4cf2520a4 100644
--- a/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_config_state_ci_status.snap
@@ -66,10 +66,4 @@ Caches GitHub/GitLab CI status for display in wt list.
See wt list CI status for display symbols and colors.
-When to use
-
-- Debug — See cached status and when it was fetched
-- Refresh — Force re-fetch with get --refresh
-- Clear — Remove stale cache entries
-
-Without a subcommand, runs get for the current branch. For --branch or --refresh, use get --branch=NAME.
+Without a subcommand, runs get for the current branch. Use get --refresh to force re-fetch or clear --all to reset cache.
diff --git a/tests/snapshots/integration__integration_tests__help__help_config_state_previous_branch.snap b/tests/snapshots/integration__integration_tests__help__help_config_state_previous_branch.snap
index 962e95dd2..2feb2df09 100644
--- a/tests/snapshots/integration__integration_tests__help__help_config_state_previous_branch.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_config_state_previous_branch.snap
@@ -13,6 +13,7 @@ info:
GIT_EDITOR: ""
RUST_LOG: warn
SOURCE_DATE_EPOCH: "1735776000"
+ TERM: alacritty
WORKTRUNK_CONFIG_PATH: /nonexistent/test/config.toml
WORKTRUNK_TEST_SKIP_URL_HEALTH_CHECK: "1"
---
@@ -50,13 +51,4 @@ Enables wt switch - to return to the previous worktree, similar to c
Updated automatically on every wt switch. Stored in git config as worktrunk.history.
-When to use
-
-Most users never need this command — the previous branch updates automatically.
-Use it to:
-
-- Debug — See what - resolves to
-- Override — Set a specific branch as "previous"
-- Clear — Reset the history
-
-Without a subcommand, runs get.
+Without a subcommand, runs get. Use set to override or clear to reset.