Skip to content

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

docs(list): note --full requirement on the JSON ci object (#3220)

Maximilian Roos2f47f29a6fe2
diff --git a/docs/content/list.md b/docs/content/list.md
index aef634527..796fdbf89 100644
--- a/docs/content/list.md
+++ b/docs/content/list.md
@@ -237,7 +237,7 @@ Query structured data with `--format=json`:
| `is_main` | boolean | Is the main worktree |
| `is_current` | boolean | Is the current worktree |
| `is_previous` | boolean | Previous worktree from wt switch |
-| `ci` | object | CI status (see below); absent when no CI |
+| `ci` | object | CI status (see below); `--full` only, then absent when no PR/MR or branch workflow |
| `repo_url` | string | Repository web URL derived from the primary remote; absent when the remote URL cannot be parsed |
| `repo` | object | Structured repository metadata (see below); includes `remote` |
| `url` | string | Dev server URL from project config; absent when not configured |
diff --git a/skills/worktrunk/reference/list.md b/skills/worktrunk/reference/list.md
index ac8052df2..00a5df036 100644
--- a/skills/worktrunk/reference/list.md
+++ b/skills/worktrunk/reference/list.md
@@ -246,7 +246,7 @@ $ wt list --format=json --full | jq '.[] | select(.ci.stale) | .branch'
| `is_main` | boolean | Is the main worktree |
| `is_current` | boolean | Is the current worktree |
| `is_previous` | boolean | Previous worktree from wt switch |
-| `ci` | object | CI status (see below); absent when no CI |
+| `ci` | object | CI status (see below); `--full` only, then absent when no PR/MR or branch workflow |
| `repo_url` | string | Repository web URL derived from the primary remote; absent when the remote URL cannot be parsed |
| `repo` | object | Structured repository metadata (see below); includes `remote` |
| `url` | string | Dev server URL from project config; absent when not configured |
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index 0187de6bb..52c7a14b2 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -984,7 +984,7 @@ $ wt list --format=json --full | jq '.[] | select(.ci.stale) | .branch'
| `is_main` | boolean | Is the main worktree |
| `is_current` | boolean | Is the current worktree |
| `is_previous` | boolean | Previous worktree from wt switch |
-| `ci` | object | CI status (see below); absent when no CI |
+| `ci` | object | CI status (see below); `--full` only, then absent when no PR/MR or branch workflow |
| `repo_url` | string | Repository web URL derived from the primary remote; absent when the remote URL cannot be parsed |
| `repo` | object | Structured repository metadata (see below); includes `remote` |
| `url` | string | Dev server URL from project config; absent when not configured |
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 0b45acb54..960fd2b66 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
@@ -313,7 +313,7 @@ Query structured data with --format=json:
is_main boolean Is the main worktree
is_current boolean Is the current worktree
is_previous boolean Previous worktree from wt switch
- ci object CI status (see below); absent when no CI
+ ci object CI status (see below); --full only, then absent when no PR/MR or branch workflow
repo_url string Repository web URL derived from the primary remote; absent when the remote URL cannot be parsed
repo object Structured repository metadata (see below); includes remote
url string Dev server URL from project config; absent when not configured
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 ab7d27639..8097bab8c 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
@@ -359,46 +359,46 @@ Query structured data with --format=json:
Fields:
- Field Type Description
- ───────────────── ─────────── ────────────────────────────────────────────────
- branch string/null Branch name (null for detached HEAD)
- path string Worktree path (absent for branches without
- worktrees)
- kind string "worktree" or "branch"
- commit object Commit info (see below)
- working_tree object Working tree state (see below)
- main_state string Relation to the default branch (see below)
- integration_reaso string Why branch is integrated (see below)
- n
- operation_state string "conflicts", "rebase", or "merge" (see
- Worktree); absent when clean
- main object Relationship to the default branch (see below);
- absent when is_main
- remote object Tracking branch info (see below); absent when no
- tracking
- worktree object Worktree metadata (see below)
- is_main boolean Is the main worktree
- is_current boolean Is the current worktree
- is_previous boolean Previous worktree from wt switch
- ci object CI status (see below); absent when no CI
- repo_url string Repository web URL derived from the primary
- remote; absent when the remote URL cannot be
- parsed
- repo object Structured repository metadata (see below);
- includes remote
- url string Dev server URL from project config; absent when
- not configured
- url_active boolean Whether the URL's port is listening; absent when
- not configured
- summary string LLM-generated branch summary; absent when not
- configured or no summary
- statusline string Pre-formatted status with ANSI colors
- symbols string Raw status symbols without colors (e.g., "!?↓")
- vars object Per-branch variables from wt config state vars
- (absent when empty)
- columns object Rendered custom column values keyed by header;
- empty cells omitted (absent when none
- configured)
+ Field Type Description
+ ──────────────── ─────────── ─────────────────────────────────────────────────
+ branch string/null Branch name (null for detached HEAD)
+ path string Worktree path (absent for branches without
+ worktrees)
+ kind string "worktree" or "branch"
+ commit object Commit info (see below)
+ working_tree object Working tree state (see below)
+ main_state string Relation to the default branch (see below)
+ integration_reas string Why branch is integrated (see below)
+ on
+ operation_state string "conflicts", "rebase", or "merge" (see Worktree);
+ absent when clean
+ main object Relationship to the default branch (see below);
+ absent when is_main
+ remote object Tracking branch info (see below); absent when no
+ tracking
+ worktree object Worktree metadata (see below)
+ is_main boolean Is the main worktree
+ is_current boolean Is the current worktree
+ is_previous boolean Previous worktree from wt switch
+ ci object CI status (see below); --full only, then absent
+ when no PR/MR or branch workflow
+ repo_url string Repository web URL derived from the primary
+ remote; absent when the remote URL cannot be
+ parsed
+ repo object Structured repository metadata (see below);
+ includes remote
+ url string Dev server URL from project config; absent when
+ not configured
+ url_active boolean Whether the URL's port is listening; absent when
+ not configured
+ summary string LLM-generated branch summary; absent when not
+ configured or no summary
+ statusline string Pre-formatted status with ANSI colors
+ symbols string Raw status symbols without colors (e.g., "!?↓")
+ vars object Per-branch variables from wt config state vars
+ (absent when empty)
+ columns object Rendered custom column values keyed by header;
+ empty cells omitted (absent when none configured)
Commit object