Skip to content

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

Add omnibus demo to docs and fix shell-init race condition

Maximilian Rooscb9180268965
diff --git a/docs/content/worktrunk.md b/docs/content/worktrunk.md
index b531f7494..5e6cf452b 100644
--- a/docs/content/worktrunk.md
+++ b/docs/content/worktrunk.md
@@ -84,7 +84,13 @@ git branch -d feat{% end %}</td>
Here's a demo with some of the more advanced features:
-![Worktrunk omnibus demo](https://cdn.jsdelivr.net/gh/max-sixty/worktrunk-assets@main/demos/wt-zellij-omnibus.gif)
+<figure class="demo">
+<picture>
+ <source srcset="/assets/wt-zellij-omnibus-dark.gif" media="(prefers-color-scheme: dark)">
+ <img src="/assets/wt-zellij-omnibus.gif" alt="Worktrunk omnibus demo: multiple Claude agents in Zellij tabs with hooks, LLM commits, and merge workflow" width="1600" height="900">
+</picture>
+<figcaption>Multiple Claude agents in parallel with hooks, LLM commits, and merge</figcaption>
+</figure>
## Install
diff --git a/docs/demos/build b/docs/demos/build
index a640bb8ff..cfb44c997 100755
--- a/docs/demos/build
+++ b/docs/demos/build
@@ -219,6 +219,15 @@ url = "http://localhost:{{ branch | hash_port }}"
'''
prepare_demo_repo(env, REPO_ROOT, hooks_config=hooks_config)
+ # Clean up branches that might exist from previous runs (billing, feature created during demo)
+ origin = env.home / "origin.git"
+ for branch in ["billing", "feature"]:
+ # Delete from origin if exists (ignore errors if not)
+ subprocess.run(
+ ["git", "-C", str(origin), "branch", "-D", branch],
+ capture_output=True
+ )
+
# Enable git colors for non-TTY environments (VHS)
git(["-C", str(env.repo), "config", "color.ui", "always"])
diff --git a/docs/demos/shared/lib.py b/docs/demos/shared/lib.py
index d098c57da..a260c68b5 100644
--- a/docs/demos/shared/lib.py
+++ b/docs/demos/shared/lib.py
@@ -154,12 +154,13 @@ def prepare_base_repo(env: DemoEnv, repo_root: Path):
- Additional mock CLIs
- Approved commands in user config
"""
- # Clean previous
+ # Clean previous (exist_ok=True handles cases where rmtree silently fails,
+ # e.g., stale processes holding files open)
shutil.rmtree(env.root, ignore_errors=True)
- env.root.mkdir(parents=True)
- env.work_base.mkdir(parents=True)
- env.repo.mkdir(parents=True)
+ env.root.mkdir(parents=True, exist_ok=True)
+ env.work_base.mkdir(parents=True, exist_ok=True)
+ env.repo.mkdir(parents=True, exist_ok=True)
# Init bare remote
run(["git", "init", "--bare", "-q", str(env.bare_remote)])
diff --git a/docs/demos/tapes/wt-statusline.tape b/docs/demos/tapes/wt-statusline.tape
index 99c27ce2b..caa60db88 100644
--- a/docs/demos/tapes/wt-statusline.tape
+++ b/docs/demos/tapes/wt-statusline.tape
@@ -47,22 +47,16 @@ Sleep 500ms
Show
Sleep 500ms
-# Show what the statusline command outputs
-Type "wt list statusline"
-Enter
-Sleep 2s
-
-# Switch to an existing worktree
+# Switch to alpha worktree first (has uncommitted changes for diff stats)
Type "wt switch alpha"
Enter
Sleep 1.5s
-# Show statusline again (now in alpha worktree)
-Type "wt list statusline"
-Enter
-Sleep 2s
-
-# Open Claude Code to show statusline integration
+# Launch Claude Code to show statusline integration
+# Tweet 12 is about seeing branch, diff stats, CI status at a glance in Claude's UI
+# Statusline will show: ~/w/acme.alpha alpha +N ● | Opus 4.5
+# Pre-enter pause for big UI takeover
+Sleep 1s
Type "claude"
Enter
-Sleep 4s
+Sleep 8s
diff --git a/docs/demos/tapes/wt-zellij-omnibus.tape b/docs/demos/tapes/wt-zellij-omnibus.tape
index 240e87bcb..c01ad8390 100644
--- a/docs/demos/tapes/wt-zellij-omnibus.tape
+++ b/docs/demos/tapes/wt-zellij-omnibus.tape
@@ -78,6 +78,10 @@ Type "y"
Sleep 1s
Show
Sleep 500ms
+# Clear any leftover characters from the permission dialog
+Type "clear"
+Enter
+Sleep 500ms
# ==== TAB 1: Overview and simple navigation ====
# Start with wt list to see all worktrees
diff --git a/docs/static/demos/twitter/thread.md b/docs/static/demos/twitter/thread.md
index e31760e98..41643add5 100644
--- a/docs/static/demos/twitter/thread.md
+++ b/docs/static/demos/twitter/thread.md
@@ -43,7 +43,7 @@ Announcing Worktrunk! A git worktree manager, designed for running AI agents in
A few points on why I'm so excited about the project, and why I hope it becomes broadly adopted 🧡
-[wt-demo.gif]
+[wt-core.gif](../../../assets/wt-core.gif)
<!-- NOTE: Considered Zellij demo here but it's too complex for tweet 1's hook role.
Placed omnibus demo at tweet 13 instead (before CTA). -->
@@ -78,7 +78,7 @@ In contrast to the git command, the Worktrunk command to create a new worktree i
𝚠𝚝 πšœπš πš’πšπšŒπš‘ --πšŒπš›πšŽπšŠπšπšŽ πšŠπš™πš’
-[wt-switch.gif β€” creating and switching between worktrees]
+[wt-switch.gif](../../../assets/wt-switch.gif)
**6/** (105 chars)
Worktrunk's other core commands:
@@ -86,7 +86,7 @@ Worktrunk's other core commands:
𝚠𝚝 πš•πš’πšœπš: see all worktrees with status
𝚠𝚝 πš›πšŽπš–πš˜πšŸπšŽ: delete a worktree
-[wt-list-remove.gif β€” list then remove]
+[wt-list-remove.gif](../../../assets/wt-list-remove.gif)
<!-- ============ PHASE 4: FEATURES ============ -->
<!-- Goal: List additional capabilities, one per tweet, snappy -->
@@ -96,7 +96,7 @@ Beyond core commands, Worktrunk has quality-of-life features to simplify working
Hooks: Post-start hooks run after creating a worktree: install deps, copy caches, start dev servers, etc. And there's a hook for every stage of a worktree lifecycle.
-[wt-hooks.gif β€” switch --create showing multiple post-start hooks running]
+[wt-hooks.gif](../../../assets/wt-hooks.gif)
<!-- TODO: Consider cutting or merging tweets 8-9. Reviewers noted:
- "50ms" is too technical / doesn't connect to AI workflows
@@ -108,32 +108,32 @@ Hooks: Post-start hooks run after creating a worktree: install deps, copy caches
𝚠𝚝 πš•πš’πšœπš --πšπšžπš•πš•: CI status as clickable dots. Green/blue/red. Clicking opens the PR.
-[wt-list.gif β€” showing progressive rendering]
+[wt-list.gif](../../../assets/wt-list.gif)
**9/** (45 chars)
𝚠𝚝 πšœπšŽπš•πšŽπšŒπš: fuzzy picker across all branches.
-[wt-select.gif]
+[wt-select-short.gif](../../../assets/wt-select-short.gif)
**10/** (99 chars)
LLM Commits: When running 𝚠𝚝 πšœπšπšŽπš™ πšŒπš˜πš–πš–πš’πš or 𝚠𝚝 πš–πšŽπš›πšπšŽ, worktrunk can have an LLM write the commit message, with a customizable template.
-[wt-commit.gif β€” git diff then wt step commit]
+[wt-commit.gif](../../../assets/wt-commit.gif)
**11/** (78 chars)
𝚠𝚝 πš–πšŽπš›πšπšŽ: squash, rebase, merge, remove worktree, delete branch, in one command.
-[wt-merge.gif]
+[wt-merge.gif](../../../assets/wt-merge.gif)
**12/** (83 chars)
@claudeai status line integration. See branch, diff stats, CI status at a glance.
-[screenshot of Claude Code with worktrunk statusline]
+[wt-statusline.gif](../../../assets/wt-statusline.gif)
**13/** (168 chars)
Putting it all together: parallel Claude Code agents in Zellij tabs, each in its own worktree. The full lifecycle: 𝚠𝚝 πšœπš πš’πšπšŒπš‘, 𝚠𝚝 πš•πš’πšœπš, 𝚠𝚝 πšœπšŽπš•πšŽπšŒπš, 𝚠𝚝 πš–πšŽπš›πšπšŽ.
-[wt-zellij-omnibus.gif]
+[wt-zellij-omnibus.gif](../../../assets/wt-zellij-omnibus.gif)
<!-- ============ PHASE 5: CTA ============ -->
<!-- Goal: Install instructions, docs, invite feedback, star -->