Skip to content

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

Refactor Twitter thread structure with omnibus demo

Maximilian Roos1645e3b24c81
diff --git a/docs/demos/CLAUDE.md b/docs/demos/CLAUDE.md
index 49897b361..1c90fc287 100644
--- a/docs/demos/CLAUDE.md
+++ b/docs/demos/CLAUDE.md
@@ -32,7 +32,7 @@ Regenerate a single demo:
| Target | Demos |
|--------|-------|
| docs | wt-core, wt-merge, wt-select |
-| twitter | wt-switch, wt-statusline, wt-list, wt-list-remove, wt-hooks, wt-commit, wt-merge, wt-select-short, wt-core, wt-zellij, wt-zellij-omnibus |
+| twitter | wt-switch, wt-statusline, wt-list, wt-list-remove, wt-hooks, wt-devserver, wt-commit, wt-merge, wt-select-short, wt-core, wt-zellij, wt-zellij-omnibus |
## vhs-keystrokes setup (REQUIRED for wt-select demos)
diff --git a/docs/demos/build b/docs/demos/build
index fad1b891e..e20694171 100755
--- a/docs/demos/build
+++ b/docs/demos/build
@@ -32,6 +32,7 @@ TAPES_DIR = SCRIPT_DIR / "tapes"
# Sizes
SIZE_ZELLIJ = DemoSize(width=1200, height=700, fontsize=16)
+SIZE_DEVSERVER = DemoSize(width=1400, height=700, fontsize=24) # Wider to show URL column
# User's real Zellij plugins directory
REAL_ZELLIJ_PLUGINS = Path.home() / ".config" / "zellij" / "plugins"
@@ -444,6 +445,41 @@ approved-commands = ["npm install", "npm run dev", "flyctl scale count 0"]
git(["-C", str(path), "push", "-u", "origin", branch, "-q"])
+def prepare_twitter_devserver(env: DemoEnv):
+ """Setup for wt-devserver demo - shows URL column in wt list."""
+ hooks_config = '''[post-start]
+dev = "npm run dev -- --port {{ branch | hash_port }} &"
+
+[list]
+url = "http://localhost:{{ branch | hash_port }}"
+'''
+ prepare_demo_repo(env, REPO_ROOT, hooks_config=hooks_config)
+
+ bin_dir = env.home / "bin"
+
+ # npm mock that starts nc listener so URL appears active
+ npm_mock = bin_dir / "npm"
+ npm_mock.write_text("""#!/bin/bash
+if [[ "$1" == "run" && "$2" == "dev" ]]; then
+ PORT="$5"
+ echo ""
+ echo " VITE v5.4.2 ready in 342 ms"
+ echo ""
+ echo " ➜ Local: http://localhost:$PORT/"
+ # Start nc listener so wt list shows URL as active (not dimmed)
+ nc -l "$PORT" >/dev/null 2>&1 &
+fi
+""")
+ npm_mock.chmod(0o755)
+
+ # User config with approved command
+ config_dir = env.home / ".config" / "worktrunk"
+ project_id = str(env.bare_remote).removesuffix(".git")
+ (config_dir / "config.toml").write_text(f'''[projects."{project_id}"]
+approved-commands = ["npm run dev -- --port {{{{ branch | hash_port }}}} &"]
+''')
+
+
def prepare_twitter_zellij(env: DemoEnv):
"""Setup for wt-zellij demo - multiple Claude Code instances in Zellij tabs."""
# No hooks for this demo - keep it simple
@@ -944,6 +980,7 @@ TWITTER_DEMOS = [
("wt-list.tape", "wt-list", prepare_twitter_core, "vhs", None),
("wt-list-remove.tape", "wt-list-remove", prepare_twitter_core, "vhs", None),
("wt-hooks.tape", "wt-hooks", prepare_twitter_hooks, "vhs", None),
+ ("wt-devserver.tape", "wt-devserver", prepare_twitter_devserver, "vhs", SIZE_DEVSERVER),
("wt-commit.tape", "wt-commit", prepare_twitter_commit, "vhs", None),
("wt-merge.tape", "wt-merge", prepare_twitter_merge, "vhs", None),
("wt-select-short.tape", "wt-select-short", prepare_twitter_select, "vhs-keystrokes", None),
diff --git a/docs/demos/tapes/wt-devserver.tape b/docs/demos/tapes/wt-devserver.tape
new file mode 100644
index 000000000..d45f0eff8
--- /dev/null
+++ b/docs/demos/tapes/wt-devserver.tape
@@ -0,0 +1,62 @@
+Output "{{OUTPUT_GIF}}"
+
+Require wt
+Require git
+
+Set Shell "fish"
+Set FontSize {{FONTSIZE}}
+Set FontFamily "Geist Mono, Berkeley Mono, Fira Code, JetBrains Mono, Menlo, Apple Color Emoji"
+Set Width {{WIDTH}}
+Set Height {{HEIGHT}}
+Set Theme {{THEME}}
+Set Padding 18
+Set LineHeight 1.12
+Set TypingSpeed 28ms
+Set CursorBlink false
+Set Framerate 30
+
+Env DEMO_REPO "{{DEMO_REPO}}"
+Env RUSTUP_HOME "{{REAL_HOME}}/.rustup"
+Env CARGO_HOME "{{REAL_HOME}}/.cargo"
+Env HOME "{{DEMO_HOME}}"
+Env XDG_CONFIG_HOME "{{DEMO_HOME}}/.config"
+Env STARSHIP_CONFIG "{{STARSHIP_CONFIG}}"
+Env GIT_TERMINAL_PROMPT "0"
+
+Hide
+Type "set -g fish_autosuggestion_enabled 0"
+Enter
+Type "set -gx LANG en_US.UTF-8; set -gx LC_ALL en_US.UTF-8"
+Enter
+Type "set -gx PATH {{TARGET_DEBUG}} $HOME/bin $PATH"
+Enter
+Type "starship init fish | source"
+Enter
+Type "wt config shell init fish | source"
+Enter
+Type "cd $DEMO_REPO"
+Enter
+Type "clear"
+Enter
+Sleep 500ms
+Show
+Sleep 500ms
+
+# Show the config: post-start hooks + URL template
+Type "cat .config/wt.toml"
+Enter
+Sleep 2s
+
+# Create a new worktree - dev server starts automatically
+Type "wt switch --create feature"
+Enter
+Sleep 3s
+
+# wt list shows the URL column
+Type "wt list"
+Enter
+Sleep 4s
+
+Type "exit"
+Enter
+Sleep 500ms
diff --git a/docs/static/demos/twitter/thread.md b/docs/static/demos/twitter/thread.md
index 6782301d8..4064e77bf 100644
--- a/docs/static/demos/twitter/thread.md
+++ b/docs/static/demos/twitter/thread.md
@@ -9,16 +9,17 @@ STRUCTURE:
5. Core command - wt switch
6. Other core commands - list, remove
7-12. Features - hooks, list + CI status, select, LLM commits, wt merge, status line
-13. CTA - install, docs, feedback, star
-14. Thanks to Claude Code team + RT request
+13. Omnibus demo - full workflow with parallel agents in Zellij
+14. CTA - install, docs, feedback, star
+15. Thanks to Claude Code team + RT request
DESIGN DECISIONS:
- Lead with "models improved → running more agents → worktrees → UX terrible → built this"
- 🧵 signals it's a thread
- Tweet 1 is link-free (hook needs max reach)
-- GitHub link in tweet 4 (what Worktrunk is); GitHub star in tweet 13 (CTA)
+- GitHub link in tweet 4 (what Worktrunk is); GitHub star in tweet 14 (CTA)
- Tweet 2 explains isolation need; tweet 3 shows UX pain; tweet 4 introduces Worktrunk; tweet 5 shows wt switch
-- Tweet 14 thanks team + RT request
+- Tweet 15 thanks team + RT request
- Core commands split across two tweets for focused demos
- Features are snappy, one per tweet, with media where applicable
- Monospace: Twitter doesn't support it; use screenshots or plain text (GIF shows commands)
@@ -44,8 +45,8 @@ A few points on why I'm so excited about the project, and why I hope it becomes
[wt-demo.gif]
-<!-- TODO: Consider a Zellij demo showing 4-5 tabs, each named by branch (via zellij-tab-name plugin),
- each with Claude Code in left pane + diff in right pane. Would powerfully show parallel agents. -->
+<!-- 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). -->
<!-- ============ PHASE 2: CONTEXT ============ -->
<!-- Goal: Why isolation matters, then prove the UX problem -->
@@ -129,10 +130,15 @@ wt merge: squash, rebase, merge, remove worktree, delete branch, in one command.
[screenshot of Claude Code with worktrunk statusline]
+**13/** (106 chars)
+Putting it all together: parallel Claude Code agents in Zellij tabs, creating features, merging them back.
+
+[wt-zellij-omnibus.gif]
+
<!-- ============ PHASE 5: CTA ============ -->
<!-- Goal: Install instructions, docs, invite feedback, star -->
-**13/** (167 chars)
+**14/** (167 chars)
To install:
brew install max-sixty/worktrunk/wt
@@ -142,10 +148,10 @@ Feedback welcome. Open an issue or reply here.
⭐ https://github.com/max-sixty/worktrunk
-**14/** (230 chars)
+**15/** (230 chars)
Big thanks to @AnthropicAI and the @claudeai team, including @bcherny @\_catwu @alexalbert\_\_, for building Claude Code. Worktrunk wouldn't exist without it 🙏
-If this was useful, the first tweet helps spread the word.
+If this was useful, liking & RT-ing the first tweet helps spread the word.
[TODO: paste link to tweet 1]