Skip to content

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

docs(list): document placeholder symbols in help text (#1496)

Maximilian Roose89049a321e1
diff --git a/docs/content/list.md b/docs/content/list.md
index 0344e94f1..675bcd35f 100644
--- a/docs/content/list.md
+++ b/docs/content/list.md
@@ -152,6 +152,15 @@ The Status column has multiple subcolumns. Within each, only the first matching
Rows are dimmed when [safe to delete](@/remove.md#branch-cleanup) (`_` same commit with clean working tree or `⊂` content integrated).
+### Placeholder symbols
+
+These appear across all columns while the table is loading:
+
+| Symbol | Meaning |
+|--------|---------|
+| `⋯` | Data is loading |
+| `·` | Skipped — collection timed out or branch too stale |
+
---
## JSON output
diff --git a/skills/worktrunk/reference/list.md b/skills/worktrunk/reference/list.md
index 62b40181d..8d37e5627 100644
--- a/skills/worktrunk/reference/list.md
+++ b/skills/worktrunk/reference/list.md
@@ -124,6 +124,15 @@ The Status column has multiple subcolumns. Within each, only the first matching
Rows are dimmed when [safe to delete](https://worktrunk.dev/remove/#branch-cleanup) (`_` same commit with clean working tree or `⊂` content integrated).
+### Placeholder symbols
+
+These appear across all columns while the table is loading:
+
+| Symbol | Meaning |
+|--------|---------|
+| `⋯` | Data is loading |
+| `·` | Skipped — collection timed out or branch too stale |
+
---
## JSON output
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index a25bc7dba..a7f28d0e3 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -580,6 +580,15 @@ The Status column has multiple subcolumns. Within each, only the first matching
Rows are dimmed when [safe to delete](@/remove.md#branch-cleanup) (`_` same commit with clean working tree or `⊂` content integrated).
+### Placeholder symbols
+
+These appear across all columns while the table is loading:
+
+| Symbol | Meaning |
+|--------|---------|
+| `⋯` | Data is loading |
+| `·` | Skipped — collection timed out or branch too stale |
+
---
## JSON output
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 f7384b6c4..8681a5051 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
@@ -168,6 +168,15 @@ The Status column has multiple subcolumns. Within each, only the first matching
Rows are dimmed when safe to delete (_ same commit with clean working tree or ⊂ content integrated).
+Placeholder symbols
+
+These appear across all columns while the table is loading:
+
+ Symbol Meaning
+ ────── ──────────────────────────────────────────────────
+ ⋯ Data is loading
+ · Skipped — collection timed out or branch too stale
+
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
JSON output
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 dcb544743..8bb0f0341 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
@@ -190,6 +190,15 @@ symbol is shown (listed in priority order):
Rows are dimmed when safe to delete (_ same commit with clean working tree or ⊂
content integrated).
+Placeholder symbols
+
+These appear across all columns while the table is loading:
+
+ Symbol Meaning
+ ────── ──────────────────────────────────────────────────
+ ⋯ Data is loading
+ · Skipped — collection timed out or branch too stale
+
────────────────────────────────────────────────────────────────────────────────
JSON output