Skip to content

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

docs: correct two docstrings the nightly survey found stale (#4167)

Worktrunk Botd70862593ad3
diff --git a/src/commands/hook_commands.rs b/src/commands/hook_commands.rs
index a92cd8055..89e992fc0 100644
--- a/src/commands/hook_commands.rs
+++ b/src/commands/hook_commands.rs
@@ -79,9 +79,15 @@ fn run_post_hook(
///
/// When hooks run during real operations (switch, merge, remove), each call site
/// builds precise vars from the actual source/destination context. When invoked
-/// manually via `wt hook <type>`, we only have the current worktree — so we
-/// provide reasonable defaults: the current branch as both base and target, and
-/// the current worktree path for directional path vars.
+/// manually via `wt hook <type>`, we only have the current worktree — so each
+/// hook type gets the directional vars its real call site sets, filled in from
+/// that worktree. The merge and remove hooks bind `target` and
+/// `target_worktree_path` to it; the switch and start hooks also bind `base`
+/// and `base_worktree_path`, naming the source a real switch starts from,
+/// which manually is that same worktree; the commit hooks bind `target` to the
+/// default branch as a stand-in for the target their real callers pass — the
+/// merge target from `wt merge`, the integration target from `wt step squash`
+/// — since `wt step commit` itself passes none.
///
/// The directional *path* vars apply either way, since the worktree exists
/// whether or not it is on a branch. The directional *branch* vars follow
diff --git a/src/commands/list/model/statusline_segment.rs b/src/commands/list/model/statusline_segment.rs
index 7dea5ae11..1ddde71b1 100644
--- a/src/commands/list/model/statusline_segment.rs
+++ b/src/commands/list/model/statusline_segment.rs
@@ -10,11 +10,13 @@ use crate::commands::list::columns::ColumnKind;
/// A segment of statusline output with priority for smart truncation.
///
-/// Priorities match `wt list` column priorities (lower = more important):
+/// Priorities match `wt list` column priorities (lower = more important), and
+/// the Claude Code-only segments sit alongside them:
/// - 0: Directory (Claude Code only)
/// - 1: Branch, Model (Claude Code only)
-/// - 2: Status symbols
-/// - 3-9: Various stats (working diff, commits, upstream, CI, URL)
+/// - 2: Status symbols, context gauge (Claude Code only)
+/// - 3: Working diff, rate-limit pace (Claude Code only)
+/// - 4-9: The remaining stats (commits, CI, branch diff, upstream, URL)
///
/// Use [`StatuslineSegment::fit_to_width`] to truncate by dropping low-priority
/// segments first.