Skip to content

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

Unify wt-select demos and fix zellij-omnibus approval mismatch

Maximilian Roos92fd28508b30
diff --git a/docs/demos/CLAUDE.md b/docs/demos/CLAUDE.md
index 370c51860..1b7d200b0 100644
--- a/docs/demos/CLAUDE.md
+++ b/docs/demos/CLAUDE.md
@@ -41,7 +41,7 @@ Regenerate a single demo:
| Target | Demos |
|--------|-------|
| docs | wt-core, wt-switch, wt-list, wt-commit, wt-statusline, wt-merge, wt-select, wt-zellij-omnibus |
-| social | wt-switch, wt-statusline, wt-list, wt-list-remove, wt-hooks, wt-devserver, wt-commit, wt-merge, wt-select-short, wt-core, wt-zellij-omnibus |
+| social | wt-switch, wt-statusline, wt-list, wt-list-remove, wt-hooks, wt-devserver, wt-commit, wt-merge, wt-select, wt-core, wt-zellij-omnibus |
## Prerequisites
@@ -73,23 +73,38 @@ Both build and fetch output to the same location (`docs/static/assets/`), so loc
## vhs-keystrokes setup (REQUIRED for wt-select demos)
-The `wt-select` demos require a custom VHS fork with keystroke overlay. **Claude must build this binary before regenerating demos.**
+The `wt-select` demos require a custom VHS fork with keystroke overlay. The `keypress-overlay` branch contains our features (bottom positioning, gold highlighting for newest key).
-Check if the binary exists:
+All commands run from **worktrunk root**:
```bash
-ls docs/demos/vhs-keystrokes/vhs-keystrokes
+# First-time setup (requires Go)
+git clone -b keypress-overlay https://github.com/max-sixty/vhs.git docs/demos/vhs-keystrokes
+(cd docs/demos/vhs-keystrokes && go build -o vhs-keystrokes .)
+
+# Update existing clone
+git -C docs/demos/vhs-keystrokes pull origin keypress-overlay
+(cd docs/demos/vhs-keystrokes && go build -o vhs-keystrokes .)
```
-If missing, **build it** (requires Go):
+The binary is gitignored. Build scripts skip wt-select GIF recording if missing.
+
+### Modifying the fork
+
+All commands run from **worktrunk root**:
```bash
-cd docs/demos
-git clone -b keypress-overlay https://github.com/max-sixty/vhs.git vhs-keystrokes
-cd vhs-keystrokes && go build -o vhs-keystrokes .
+# 1. Rebuild and test
+(cd docs/demos/vhs-keystrokes && go build -o vhs-keystrokes .)
+./docs/demos/build docs --only wt-select
+
+# 2. Commit and push
+git -C docs/demos/vhs-keystrokes add -A
+git -C docs/demos/vhs-keystrokes commit -m "Description"
+git -C docs/demos/vhs-keystrokes push origin keypress-overlay
```
-The binary is gitignored. Build scripts skip wt-select GIF recording if missing—**always build vhs-keystrokes first** when regenerating demos.
+**CRITICAL**: Always push to `origin keypress-overlay` after changes. The directory is gitignored from worktrunk—changes only persist in the vhs fork repo.
### Keystroke timing calibration
diff --git a/docs/demos/build b/docs/demos/build
index 2210a1489..2b5ea75c7 100755
--- a/docs/demos/build
+++ b/docs/demos/build
@@ -307,7 +307,7 @@ SOCIAL_DEMOS = [
partial(prepare_merge_demo, commit_generation=False, staged_changes=False),
"vhs",
),
- ("wt-select-short.tape", "wt-select-short", prepare_basic, "vhs-keystrokes"),
+ ("wt-select.tape", "wt-select", prepare_basic, "vhs-keystrokes"),
("wt-core.tape", "wt-core", prepare_with_hooks, "vhs"),
("wt-zellij-omnibus.tape", "wt-zellij-omnibus", prepare_zellij_omnibus, "vhs"),
]
diff --git a/docs/demos/tapes/wt-select-short.tape b/docs/demos/tapes/wt-select-short.tape
deleted file mode 100644
index 7bd3f7aaf..000000000
--- a/docs/demos/tapes/wt-select-short.tape
+++ /dev/null
@@ -1,41 +0,0 @@
-Source docs/demos/tapes/shared-setup.tape
-
-Output "{{OUTPUT_GIF}}"
-
-Source docs/demos/tapes/shared-commands.tape
-
-Type "clear"
-Enter
-Sleep 500ms
-Show
-Set KeyStrokes Show
-Sleep 500ms
-
-# Launch wt select
-Type "wt select"
-Enter
-Sleep 1.5s
-
-# Quick browse - second down comes fast
-Down
-Sleep 0.1s
-Down
-Sleep 0.8s
-
-# Scroll the diff panel with Ctrl+D
-Ctrl+d
-Sleep 0.5s
-Ctrl+d
-Sleep 3s
-
-# Filter to find alpha branch
-Type "alp"
-Sleep 1s
-
-# Select it
-Enter
-Sleep 1.5s
-
-Type "exit"
-Enter
-Sleep 500ms
diff --git a/docs/demos/tapes/wt-select.tape b/docs/demos/tapes/wt-select.tape
index fc78451b9..d167acad9 100644
--- a/docs/demos/tapes/wt-select.tape
+++ b/docs/demos/tapes/wt-select.tape
@@ -14,34 +14,29 @@ Sleep 500ms
# Launch wt select
Type "wt select"
Enter
-Sleep 2s
+Sleep 1.5s
-# Navigate to alpha branch (has large main…± diff and working tree changes)
+# Quick browse - second down comes fast
Down
-Sleep 1s
+Sleep 0.1s
Down
-Sleep 1.5s
+Sleep 0.8s
-# Switch to main…± tab (panel 3) to see committed diff from main
-Type "3"
-Sleep 1.5s
-
-# Browse the diff with Ctrl+D (shows scrolling through large diff)
+# Scroll the diff panel with Ctrl+D
Ctrl+d
-Sleep 1s
+Sleep 0.5s
Ctrl+d
-Sleep 1s
+Sleep 0.5s
Ctrl+d
-Sleep 1.5s
+Sleep 3s
-# Filter to narrow down and select
+# Filter to find alpha branch
Type "alp"
-Sleep 1.5s
-Enter
-Sleep 2s
+Sleep 1s
-# Show we're now in the worktree
-Sleep 500ms
+# Select it
+Enter
+Sleep 1.5s
Type "exit"
Enter