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.mdindex 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/buildindex fad1b891e..e20694171 100755--- a/docs/demos/build+++ b/docs/demos/build@@ -32,6 +32,7 @@ TAPES_DIR = SCRIPT_DIR / "tapes"# SizesSIZE_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 directoryREAL_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.tapenew file mode 100644index 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 500msdiff --git a/docs/static/demos/twitter/thread.md b/docs/static/demos/twitter/thread.mdindex 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 switch6. Other core commands - list, remove7-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 requestDESIGN 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]