Skip to content

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

Docs: Add wt-select demo prerequisites and update gitignore

Maximilian Roosa5f24bab24e4
diff --git a/docs/CLAUDE.md b/docs/CLAUDE.md
index a7fd7dba3..6a022409e 100644
--- a/docs/CLAUDE.md
+++ b/docs/CLAUDE.md
@@ -267,12 +267,24 @@ Demo GIFs (~2MB each) are stored in a separate `worktrunk-assets` repo to avoid
**To update demos:**
```bash
./docs/demos/wt/build # Build from VHS tape file
-./docs/demos/wt-select/build # Build select demo
+./docs/demos/wt-select/build # Build select demo (requires vhs-keystrokes, see below)
./scripts/publish-assets # Push to assets repo
```
Deploy runs `fetch-assets` before building.
+### wt-select prerequisites
+
+The `wt-select` demo requires a custom VHS fork with keystroke overlay. Build it once:
+
+```bash
+cd docs/demos/wt-select
+git clone -b keypress-overlay https://github.com/max-sixty/vhs.git vhs-keystrokes
+cd vhs-keystrokes && go build -o vhs-keystrokes .
+```
+
+The build script looks for `docs/demos/wt-select/vhs-keystrokes/vhs-keystrokes`.
+
### Light/dark theme variants
Each demo build generates both light and dark GIF variants:
diff --git a/docs/demos/wt-select/.gitignore b/docs/demos/wt-select/.gitignore
index a60fb2bc6..bab312f80 100644
--- a/docs/demos/wt-select/.gitignore
+++ b/docs/demos/wt-select/.gitignore
@@ -1,2 +1,5 @@
# Build output
out/
+
+# Custom VHS fork (built locally)
+vhs-keystrokes/