Skip to content

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

docs: fit terminal examples on desktop (#4039)

Maximilian Roosa0ad432a04c6
diff --git a/docs/src/content/docs/claude-code.md b/docs/src/content/docs/claude-code.md
index 86961bb34..4d0451771 100644
--- a/docs/src/content/docs/claude-code.md
+++ b/docs/src/content/docs/claude-code.md
@@ -90,13 +90,13 @@ The Claude Code, Codex, OpenCode, Pi, and Gemini plugins track agent sessions wi
```console
$ wt list
- Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message
-@ main ^⇡ ⇡1 . 33323bc 1d Initial commit
-+ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints
-+ review-ui ? ↑ 💬 +1 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component
-+ wip-docs ? – +1 ../repo.wip-docs 33323bc 1d Initial commit
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ main ^⇡ ⇡1 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 70343f0 1d Add REST API endp…
++ review-ui ? ↑ 💬 +1 ↑1 +1 a585d6e 1d Add dashboard com…
++ wip-docs ? – +1 33323bc 1d Initial commit
-○ Showing 4 worktrees, 2 with changes, 2 ahead
+○ Showing 4 worktrees, 2 with changes, 2 ahead, hidden: Path
```
<!-- END AUTO-GENERATED -->
diff --git a/docs/src/content/docs/list.md b/docs/src/content/docs/list.md
index c5302e7ef..95a3140ba 100644
--- a/docs/src/content/docs/list.md
+++ b/docs/src/content/docs/list.md
@@ -42,28 +42,28 @@ Include CI status and LLM summaries:
```console
$ wt list --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
-○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message
+○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message
```
Include branches that don't have worktrees:
```console
$ wt list --branches --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
-/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922
-/ wip /↕ ↑1 ↓1 +33 Start API documentation b40716d
-
-○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
+/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and…
+/ wip /↕ ↑1 ↓1 +33 Start API documentation
+
+○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message
```
Output as JSON for scripting:
diff --git a/docs/src/generated/terminal-styles.json b/docs/src/generated/terminal-styles.json
index b156e7a2f..45725cbaf 100644
--- a/docs/src/generated/terminal-styles.json
+++ b/docs/src/generated/terminal-styles.json
@@ -1090,390 +1090,6 @@
],
"plain": " Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message\n@ main ^⇡ ⇡1 33323bc 1d Initial commit\n+ feature-api ↑ 🤖 ↑1 +1 70343f0 1d Add REST API endp…\n+ review-ui ? ↑ 💬 +1 ↑1 +1 a585d6e 1d Add dashboard com…\n+ wip-docs ? – +1 33323bc 1d Initial commit\n\n○ Showing 4 worktrees, 2 with changes, 2 ahead, hidden: Path"
},
- {
- "lines": [
- [
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Branch"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Status"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "HEAD±"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "main↕"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "main…±"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Remote⇅"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Path"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Commit"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Age"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Message"
- }
- ],
- [
- {
- "classes": [],
- "text": "@ main "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "^⇡"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-green"
- ],
- "text": "⇡1"
- },
- {
- "classes": [],
- "text": " . "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "33323bc"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "1d"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "Initial commit"
- }
- ],
- [
- {
- "classes": [],
- "text": "+ feature-api "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "↑"
- },
- {
- "classes": [],
- "text": " 🤖 "
- },
- {
- "classes": [
- "wt-terminal-green"
- ],
- "text": "↑1"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-green"
- ],
- "text": "+1"
- },
- {
- "classes": [],
- "text": " ../repo.feature-api "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "70343f0"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "1d"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "Add REST API endpoints"
- }
- ],
- [
- {
- "classes": [],
- "text": "+ review-ui "
- },
- {
- "classes": [
- "wt-terminal-cyan"
- ],
- "text": "?"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "↑"
- },
- {
- "classes": [],
- "text": " 💬 "
- },
- {
- "classes": [
- "wt-terminal-green"
- ],
- "text": "+1"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-green"
- ],
- "text": "↑1"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-green"
- ],
- "text": "+1"
- },
- {
- "classes": [],
- "text": " ../repo.review-ui "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "a585d6e"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "1d"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "Add dashboard component"
- }
- ],
- [
- {
- "classes": [],
- "text": "+ wip-docs "
- },
- {
- "classes": [
- "wt-terminal-cyan"
- ],
- "text": "?"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "–"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-green"
- ],
- "text": "+1"
- },
- {
- "classes": [],
- "text": " ../repo.wip-docs "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "33323bc"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "1d"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "Initial commit"
- }
- ],
- [],
- [
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "○"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "Showing 4 worktrees, 2 with changes, 2 ahead"
- }
- ]
- ],
- "plain": " Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message\n@ main ^⇡ ⇡1 . 33323bc 1d Initial commit\n+ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints\n+ review-ui ? ↑ 💬 +1 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component\n+ wip-docs ? – +1 ../repo.wip-docs 33323bc 1d Initial commit\n\n○ Showing 4 worktrees, 2 with changes, 2 ahead"
- },
{
"lines": [
[
@@ -1966,7 +1582,7 @@
},
{
"classes": [],
- "text": " "
+ "text": " "
},
{
"classes": [
@@ -1983,16 +1599,6 @@
"wt-terminal-bold"
],
"text": "CI"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Commit"
}
],
[
@@ -2079,7 +1685,7 @@
},
{
"classes": [],
- "text": " Refactor API to REST architecture with middleware "
+ "text": " Refactor API to REST archi… "
},
{
"classes": [
@@ -2097,16 +1703,6 @@
"wt-terminal-dim"
],
"text": "#412"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "6814f02"
}
],
[
@@ -2122,7 +1718,7 @@
},
{
"classes": [],
- "text": " "
+ "text": " "
},
{
"classes": [
@@ -2150,16 +1746,6 @@
"wt-terminal-green"
],
"text": "#"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "41ee083"
}
],
[
@@ -2216,7 +1802,7 @@
},
{
"classes": [],
- "text": " Harden auth with constant-time token validation "
+ "text": " Harden auth with constant-… "
},
{
"classes": [
@@ -2233,16 +1819,6 @@
"wt-terminal-green"
],
"text": "#408"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "b772e68"
}
],
[
@@ -2268,7 +1844,7 @@
},
{
"classes": [],
- "text": " "
+ "text": " "
},
{
"classes": [
@@ -2285,16 +1861,6 @@
"wt-terminal-green"
],
"text": "#410"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "41ee083"
}
],
[],
@@ -2313,11 +1879,11 @@
"classes": [
"wt-terminal-dim"
],
- "text": "Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message"
+ "text": "Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message"
}
]
],
- "plain": " Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit\n@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02\n^ main ^⇅ ⇡1 ⇣1 # 41ee083\n+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68\n+ fix-typos _| | #410 41ee083\n\n○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message"
+ "plain": " Branch Status HEAD± main↕ main…± Summary Remote⇅ CI\n@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412\n^ main ^⇅ ⇡1 ⇣1 #\n+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408\n+ fix-typos _| | #410\n\n○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message"
},
{
"lines": [
@@ -2384,7 +1950,7 @@
},
{
"classes": [],
- "text": " "
+ "text": " "
},
{
"classes": [
@@ -2401,16 +1967,6 @@
"wt-terminal-bold"
],
"text": "CI"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-bold"
- ],
- "text": "Commit"
}
],
[
@@ -2497,7 +2053,7 @@
},
{
"classes": [],
- "text": " Refactor API to REST architecture with middleware "
+ "text": " Refactor API to REST archi… "
},
{
"classes": [
@@ -2515,16 +2071,6 @@
"wt-terminal-dim"
],
"text": "#412"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "6814f02"
}
],
[
@@ -2540,7 +2086,7 @@
},
{
"classes": [],
- "text": " "
+ "text": " "
},
{
"classes": [
@@ -2568,16 +2114,6 @@
"wt-terminal-green"
],
"text": "#"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "41ee083"
}
],
[
@@ -2634,7 +2170,7 @@
},
{
"classes": [],
- "text": " Harden auth with constant-time token validation "
+ "text": " Harden auth with constant-… "
},
{
"classes": [
@@ -2651,16 +2187,6 @@
"wt-terminal-green"
],
"text": "#408"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "b772e68"
}
],
[
@@ -2686,7 +2212,7 @@
},
{
"classes": [],
- "text": " "
+ "text": " "
},
{
"classes": [
@@ -2703,16 +2229,6 @@
"wt-terminal-green"
],
"text": "#410"
- },
- {
- "classes": [],
- "text": " "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "41ee083"
}
],
[
@@ -2765,13 +2281,7 @@
},
{
"classes": [],
- "text": " Explore GraphQL schema and resolvers "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "9637922"
+ "text": " Explore GraphQL schema and…"
}
],
[
@@ -2824,13 +2334,7 @@
},
{
"classes": [],
- "text": " Start API documentation "
- },
- {
- "classes": [
- "wt-terminal-dim"
- ],
- "text": "b40716d"
+ "text": " Start API documentation"
}
],
[],
@@ -2849,11 +2353,11 @@
"classes": [
"wt-terminal-dim"
],
- "text": "Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message"
+ "text": "Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message"
}
]
],
- "plain": " Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit\n@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02\n^ main ^⇅ ⇡1 ⇣1 # 41ee083\n+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68\n+ fix-typos _| | #410 41ee083\n/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922\n/ wip /↕ ↑1 ↓1 +33 Start API documentation b40716d\n\n○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message"
+ "plain": " Branch Status HEAD± main↕ main…± Summary Remote⇅ CI\n@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412\n^ main ^⇅ ⇡1 ⇣1 #\n+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408\n+ fix-typos _| | #410\n/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and…\n/ wip /↕ ↑1 ↓1 +33 Start API documentation\n\n○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message"
},
{
"lines": [
diff --git a/docs/src/styles/custom.css b/docs/src/styles/custom.css
index 3ac6c8afa..7f9e861e0 100644
--- a/docs/src/styles/custom.css
+++ b/docs/src/styles/custom.css
@@ -50,8 +50,8 @@
--sl-color-hairline-light: var(--wt-line);
--sl-color-hairline: var(--wt-line);
--sl-color-hairline-shade: var(--wt-line);
- --sl-content-width: 50rem;
- --sl-sidebar-width: 17rem;
+ --sl-content-width: 62rem;
+ --sl-sidebar-width: 14rem;
}
:root[data-theme='dark'] {
@@ -714,6 +714,41 @@ figure.demo img {
}
}
+/* Keep the compact table of contents until both sidebars leave room for examples. */
+@media (min-width: 72rem) and (max-width: 85.99rem) {
+ :root {
+ --sl-mobile-toc-height: 3rem;
+ }
+
+ [data-has-toc] .lg\:sl-flex:has(> .right-sidebar-container) {
+ flex-wrap: wrap;
+ }
+
+ [data-has-toc] .right-sidebar-container,
+ [data-has-sidebar][data-has-toc] .main-pane,
+ html:has(.wt-home) .main-pane {
+ flex-basis: 100%;
+ width: 100%;
+ }
+
+ [data-has-toc] .right-sidebar {
+ position: static;
+ border-inline-start: 0;
+ padding-top: 0;
+ width: auto;
+ height: auto;
+ overflow-y: visible;
+ }
+
+ [data-has-toc] .right-sidebar .lg\:sl-hidden {
+ display: block;
+ }
+
+ [data-has-toc] .right-sidebar-panel {
+ display: none;
+ }
+}
+
@media (max-width: 49.99rem) {
.sl-markdown-content h2 {
font-size: 1.8rem;
diff --git a/docs/tests/browser-site.test.mjs b/docs/tests/browser-site.test.mjs
index c3da4d663..f93736d22 100644
--- a/docs/tests/browser-site.test.mjs
+++ b/docs/tests/browser-site.test.mjs
@@ -196,6 +196,39 @@ test('mobile pages stay viewport-bound while code remains readable', { timeout:
}
});
+test('desktop terminal examples fit without horizontal scrolling', { timeout: 60_000 }, async () => {
+ const browser = await webkit.launch();
+ try {
+ for (const width of [1152, 1376]) {
+ const page = await browser.newPage({ viewport: { width, height: 900 } });
+ for (const route of await sitemapRoutes()) {
+ await page.goto(`${baseUrl}${route}`, { waitUntil: 'domcontentloaded' });
+ const terminals = await page.evaluate(() => (
+ [...document.querySelectorAll('.frame.is-terminal')]
+ .filter((frame) => frame.querySelector('.wt-output'))
+ .map((frame) => {
+ const pre = frame.querySelector('pre');
+ return {
+ command: frame.querySelector('.wt-command')?.textContent.trim(),
+ clientWidth: pre.clientWidth,
+ scrollWidth: pre.scrollWidth,
+ };
+ })
+ ));
+ for (const terminal of terminals) {
+ assert.ok(
+ terminal.scrollWidth <= terminal.clientWidth + 1,
+ `${route} ${terminal.command} scrolls horizontally at ${width}px`,
+ );
+ }
+ }
+ await page.close();
+ }
+ } finally {
+ await browser.close();
+ }
+});
+
test('code artifacts keep their visual hierarchy in both themes', async () => {
const browser = await webkit.launch();
try {
diff --git a/plugins/worktrunk/skills/worktrunk/reference/claude-code.md b/plugins/worktrunk/skills/worktrunk/reference/claude-code.md
index 7ff14c69a..964eeb4ed 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/claude-code.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/claude-code.md
@@ -84,13 +84,13 @@ The Claude Code, Codex, OpenCode, Pi, and Gemini plugins track agent sessions wi
```console
$ wt list
- Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message
-@ main ^⇡ ⇡1 . 33323bc 1d Initial commit
-+ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints
-+ review-ui ? ↑ 💬 +1 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component
-+ wip-docs ? – +1 ../repo.wip-docs 33323bc 1d Initial commit
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ main ^⇡ ⇡1 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 70343f0 1d Add REST API endp…
++ review-ui ? ↑ 💬 +1 ↑1 +1 a585d6e 1d Add dashboard com…
++ wip-docs ? – +1 33323bc 1d Initial commit
-○ Showing 4 worktrees, 2 with changes, 2 ahead
+○ Showing 4 worktrees, 2 with changes, 2 ahead, hidden: Path
```
- 🤖 — agent is working
diff --git a/plugins/worktrunk/skills/worktrunk/reference/list.md b/plugins/worktrunk/skills/worktrunk/reference/list.md
index 359aabd18..15c437e74 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/list.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/list.md
@@ -29,28 +29,28 @@ Include CI status and LLM summaries:
```console
$ wt list --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
-○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message
+○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message
```
Include branches that don't have worktrees:
```console
$ wt list --branches --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
-/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922
-/ wip /↕ ↑1 ↓1 +33 Start API documentation b40716d
-
-○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
+/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and…
+/ wip /↕ ↑1 ↓1 +33 Start API documentation
+
+○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message
```
Output as JSON for scripting:
diff --git a/skills/worktrunk/reference/claude-code.md b/skills/worktrunk/reference/claude-code.md
index 7ff14c69a..964eeb4ed 100644
--- a/skills/worktrunk/reference/claude-code.md
+++ b/skills/worktrunk/reference/claude-code.md
@@ -84,13 +84,13 @@ The Claude Code, Codex, OpenCode, Pi, and Gemini plugins track agent sessions wi
```console
$ wt list
- Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message
-@ main ^⇡ ⇡1 . 33323bc 1d Initial commit
-+ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints
-+ review-ui ? ↑ 💬 +1 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component
-+ wip-docs ? – +1 ../repo.wip-docs 33323bc 1d Initial commit
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ main ^⇡ ⇡1 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 70343f0 1d Add REST API endp…
++ review-ui ? ↑ 💬 +1 ↑1 +1 a585d6e 1d Add dashboard com…
++ wip-docs ? – +1 33323bc 1d Initial commit
-○ Showing 4 worktrees, 2 with changes, 2 ahead
+○ Showing 4 worktrees, 2 with changes, 2 ahead, hidden: Path
```
- 🤖 — agent is working
diff --git a/skills/worktrunk/reference/list.md b/skills/worktrunk/reference/list.md
index 359aabd18..15c437e74 100644
--- a/skills/worktrunk/reference/list.md
+++ b/skills/worktrunk/reference/list.md
@@ -29,28 +29,28 @@ Include CI status and LLM summaries:
```console
$ wt list --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
-○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message
+○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message
```
Include branches that don't have worktrees:
```console
$ wt list --branches --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
-/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922
-/ wip /↕ ↑1 ↓1 +33 Start API documentation b40716d
-
-○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
+/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and…
+/ wip /↕ ↑1 ↓1 +33 Start API documentation
+
+○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message
```
Output as JSON for scripting:
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index 8640c576f..92b4f47f9 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -809,13 +809,13 @@ Include CI status and LLM summaries:
<!-- wt list --full -->
```console
$ wt list --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
-○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message
+○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message
```
Include branches that don't have worktrees:
@@ -823,15 +823,15 @@ Include branches that don't have worktrees:
<!-- wt list --branches --full -->
```console
$ wt list --branches --full
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
-/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922
-/ wip /↕ ↑1 ↓1 +33 Start API documentation b40716d
-
-○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
+/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and…
+/ wip /↕ ↑1 ↓1 +33 Start API documentation
+
+○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message
```
Output as JSON for scripting:
diff --git a/tests/integration_tests/list.rs b/tests/integration_tests/list.rs
index 4060a883f..6a8d79130 100644
--- a/tests/integration_tests/list.rs
+++ b/tests/integration_tests/list.rs
@@ -1160,7 +1160,7 @@ fn setup_user_marker_example(repo: &mut TestRepo) {
#[rstest]
fn test_list_with_user_marker(mut repo: TestRepo) {
setup_user_marker_example(&mut repo);
- assert_cmd_snapshot!(list_snapshots::command(&repo, repo.root_path()));
+ assert_cmd_snapshot!(list_snapshots::command_readme(&repo, repo.root_path()));
}
#[rstest]
@@ -2681,7 +2681,7 @@ fn test_readme_example_list(mut repo: TestRepo) {
/// Generate README example: `wt list --full` output
///
/// Shows additional columns: main…± (line diffs), CI status, and LLM summaries.
-/// Uses wider terminal (134 cols) than the base example to fit the Summary column.
+/// Uses the documentation width (98 cols) so the sample fits the site content column.
/// Output: tests/snapshots/integration__integration_tests__list__readme_example_list_full.snap
#[rstest]
fn test_readme_example_list_full(mut repo: TestRepo) {
@@ -2689,7 +2689,6 @@ fn test_readme_example_list_full(mut repo: TestRepo) {
assert_cmd_snapshot!("readme_example_list_full", {
let mut cmd = list_snapshots::command_readme(&repo, &feature_api);
cmd.arg("--full");
- cmd.env("COLUMNS", "134");
cmd
});
}
@@ -2697,7 +2696,7 @@ fn test_readme_example_list_full(mut repo: TestRepo) {
/// Generate README example: `wt list --branches --full` output
///
/// Shows branches without worktrees (⎇ symbol) alongside worktrees, plus CI status.
-/// Uses wider terminal (134 cols) than the base example to fit the Summary column.
+/// Uses the documentation width (98 cols) so the sample fits the site content column.
/// Output: tests/snapshots/integration__integration_tests__list__readme_example_list_branches.snap
#[rstest]
fn test_readme_example_list_branches(mut repo: TestRepo) {
@@ -2705,7 +2704,6 @@ fn test_readme_example_list_branches(mut repo: TestRepo) {
assert_cmd_snapshot!("readme_example_list_branches", {
let mut cmd = list_snapshots::command_readme(&repo, &feature_api);
cmd.args(["--branches", "--full"]);
- cmd.env("COLUMNS", "134");
cmd
});
}
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 3583fd043..6a73cab00 100644
--- a/tests/snapshots/integration__integration_tests__help__help_list_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_list_long.snap
@@ -114,26 +114,26 @@ List all worktrees:
Include CI status and LLM summaries:
  wt list --full
-   Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-  @ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-  ^ main ^⇅ ⇡1 ⇣1 # 41ee083
-  + fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-  + fix-typos _| | #410 41ee083
+   Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+  @ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+  ^ main ^⇅ ⇡1 ⇣1 #
+  + fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
+  + fix-typos _| | #410
  
-  ○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message
+  ○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message
Include branches that don't have worktrees:
  wt list --branches --full
-   Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-  @ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-  ^ main ^⇅ ⇡1 ⇣1 # 41ee083
-  + fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-  + fix-typos _| | #410 41ee083
-  / exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922
-  / wip /↕ ↑1 ↓1 +33 Start API documentation b40716d
+   Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+  @ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+  ^ main ^⇅ ⇡1 ⇣1 #
+  + fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
+  + fix-typos _| | #410
+  / exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and…
+  / wip /↕ ↑1 ↓1 +33 Start API documentation
  
-  ○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message
+  ○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message
Output as JSON for scripting:
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 db8377f9f..ced9a6ec4 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
@@ -131,7 +131,7 @@ Include CI status and LLM summaries:
  + fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with cons…
  + fix-typos _| …
  
-  ○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message
+  ○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Me…
Include branches that don't have worktrees:
@@ -144,7 +144,7 @@ Include branches that don't have worktrees:
  / exp /↕ ↑2 ↓1 +137 Explore GraphQL schem…
  / wip /↕ ↑1 ↓1 +33 Start API documentati…
  
-  ○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age…
+  ○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Com…
Output as JSON for scripting:
diff --git a/tests/snapshots/integration__integration_tests__list__list_with_user_marker.snap b/tests/snapshots/integration__integration_tests__list__list_with_user_marker.snap
index 65367c770..a1ec07c2c 100644
--- a/tests/snapshots/integration__integration_tests__list__list_with_user_marker.snap
+++ b/tests/snapshots/integration__integration_tests__list__list_with_user_marker.snap
@@ -8,7 +8,7 @@ info:
APPDATA: "[TEST_CONFIG_HOME]"
CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
CLICOLOR_FORCE: "1"
- COLUMNS: "500"
+ COLUMNS: "98"
GIT_ALLOW_PROTOCOL: file
GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
GIT_AUTHOR_EMAIL: [email protected]
@@ -56,12 +56,12 @@ info:
success: true
exit_code: 0
----- stdout -----
- Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message
-@ main ^⇡ ⇡1 . 33323bc 1d Initial commit
-+ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints
-+ review-ui ? ↑ 💬 +1 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component
-+ wip-docs ? – +1 ../repo.wip-docs 33323bc 1d Initial commit
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ main ^⇡ ⇡1 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 70343f0 1d Add REST API endp…
++ review-ui ? ↑ 💬 +1 ↑1 +1 a585d6e 1d Add dashboard com…
++ wip-docs ? – +1 33323bc 1d Initial commit
----- stderr -----
-○ Showing 4 worktrees, 2 with changes, 2 ahead
+○ Showing 4 worktrees, 2 with changes, 2 ahead, hidden: Path
diff --git a/tests/snapshots/integration__integration_tests__list__readme_example_list_branches.snap b/tests/snapshots/integration__integration_tests__list__readme_example_list_branches.snap
index f810f5faa..d6428b669 100644
--- a/tests/snapshots/integration__integration_tests__list__readme_example_list_branches.snap
+++ b/tests/snapshots/integration__integration_tests__list__readme_example_list_branches.snap
@@ -10,7 +10,7 @@ info:
APPDATA: "[TEST_CONFIG_HOME]"
CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
CLICOLOR_FORCE: "1"
- COLUMNS: "134"
+ COLUMNS: "98"
GIT_ALLOW_PROTOCOL: file
GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
GIT_AUTHOR_EMAIL: [email protected]
@@ -58,14 +58,14 @@ info:
success: true
exit_code: 0
----- stdout -----
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
-/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922
-/ wip /↕ ↑1 ↓1 +33 Start API documentation b40716d
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
+/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and…
+/ wip /↕ ↑1 ↓1 +33 Start API documentation
----- stderr -----
-○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Age, Message
+○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, hidden: Path, Commit, Age, Message
diff --git a/tests/snapshots/integration__integration_tests__list__readme_example_list_full.snap b/tests/snapshots/integration__integration_tests__list__readme_example_list_full.snap
index 1bdcfc860..a5b8218d7 100644
--- a/tests/snapshots/integration__integration_tests__list__readme_example_list_full.snap
+++ b/tests/snapshots/integration__integration_tests__list__readme_example_list_full.snap
@@ -9,7 +9,7 @@ info:
APPDATA: "[TEST_CONFIG_HOME]"
CLAUDE_CONFIG_DIR: "[TEST_CLAUDE_CONFIG]"
CLICOLOR_FORCE: "1"
- COLUMNS: "134"
+ COLUMNS: "98"
GIT_ALLOW_PROTOCOL: file
GIT_AUTHOR_DATE: "2025-01-01T00:00:00Z"
GIT_AUTHOR_EMAIL: [email protected]
@@ -57,12 +57,12 @@ info:
success: true
exit_code: 0
----- stdout -----
- Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
-@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
-^ main ^⇅ ⇡1 ⇣1 # 41ee083
-+ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
-+ fix-typos _| | #410 41ee083
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST archi… ⇡3 #412
+^ main ^⇅ ⇡1 ⇣1 #
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-… | #408
++ fix-typos _| | #410
----- stderr -----
-○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Age, Message
+○ Showing 4 worktrees, 1 with changes, 2 ahead, hidden: Path, Commit, Age, Message