Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows
Simplify Twitter thread demo with published metadata
Maximilian Roos66fe9b0ddd8a
diff --git a/docs/static/demos/twitter/thread.md b/docs/static/demos/twitter/thread.mdindex 223e7586c..714f5313a 100644--- a/docs/static/demos/twitter/thread.md+++ b/docs/static/demos/twitter/thread.md@@ -1,166 +1,105 @@# Twitter Thread: Worktrunk Launch-<!---STRUCTURE:-1. Intro - hook with announcement (link-free for max reach)-2. Context - Claude Code instances, why isolation matters-3. Git worktree UX problem-4. What Worktrunk is + GitHub link-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. 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 14 (CTA)-- Tweet 2 explains isolation need; tweet 3 shows UX pain; tweet 4 introduces Worktrunk; tweet 5 shows wt switch-- 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)-- Social proof (PRQL, xarray, insta) cut for now to keep focus on the tool--->+Published: Dec 30, 2025+URL: https://x.com/max_sixty/status/2006077845391724739----<!-- ============ PHASE 1: INTRO ============ -->-<!-- Goal: Hook, announce, explain what it is, set up the thread -->--<!-- TODO: Wordsmith tweets 1-2. Current version is functional but doesn't sing.- Attempted combining them but lost clarity. Key requirements:- - Tweet 1 must say what Worktrunk is (git worktree manager)- - Need to convey the AI agent use case without being abstract- - Lead with concrete pain, not marketing speak- - Avoid slop: "fills the gap", "painful UX", "actually usable" -->--**1/** (190 chars)+**1/**Announcing Worktrunk! A git worktree manager, designed for running AI agents in parallel.A few points on why I'm so excited about the project, and why I hope it becomes broadly adopted 🧵-[wt-core.gif](../../../assets/social/light/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). -->+[wt-core.gif]-<!-- ============ PHASE 2: CONTEXT ============ -->-<!-- Goal: Why isolation matters, then prove the UX problem -->--**2/** (202 chars)+**2/**As models have improved this year, I've been running more & more Claude Code instances in parallel, often 5-10.Each needs its own isolated working directory, otherwise they get confused by each other's changes.-**3/** (222 chars)+**3/**Git worktrees solve this, but the UX is terrible!To create & navigate to a new worktree in git:-𝚐𝚒𝚝 𝚠𝚘𝚛𝚔𝚝𝚛𝚎𝚎 𝚊𝚍𝚍 -𝚋 𝚏𝚎𝚊𝚝 ../𝚛𝚎𝚙𝚘.𝚏𝚎𝚊𝚝 && 𝚌𝚍 ../𝚛𝚎𝚙𝚘.𝚏𝚎𝚊𝚝+git worktree add -b feat ../repo.feat && cd ../repo.feat...even for a simple command, we need to type the name three times.-<!-- ============ PHASE 3: CORE COMMANDS ============ -->-<!-- Goal: Contrast with solution, then introduce core commands -->--**4/** (167 chars)+**4/**Worktrunk is a CLI, written in Rust, which makes git worktrees as easy as branches.-https://github.com/max-sixty/worktrunk+[worktrunk.dev card]-**5/** (99 chars)+**5/**In contrast to the git command, the Worktrunk command to create a new worktree is short (& aliasable):-𝚠𝚝 𝚜𝚠𝚒𝚝𝚌𝚑 --𝚌𝚛𝚎𝚊𝚝𝚎 𝚊𝚙𝚒+wt switch --create api-[wt-switch.gif](../../../assets/social/light/wt-switch.gif)+[wt-switch.gif]-**6/** (105 chars)+**6/**Worktrunk's other core commands:-𝚠𝚝 𝚕𝚒𝚜𝚝: see all worktrees with status-𝚠𝚝 𝚛𝚎𝚖𝚘𝚟𝚎: delete a worktree--[wt-list-remove.gif](../../../assets/social/light/wt-list-remove.gif)+wt list: see all worktrees with status+wt remove: delete a worktree-<!-- ============ PHASE 4: FEATURES ============ -->-<!-- Goal: List additional capabilities, one per tweet, snappy -->+[wt-list-remove.gif]-**7/** (275 chars)+**7/**Beyond core commands, Worktrunk has quality-of-life features to simplify working with many parallel changes: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](../../../assets/social/light/wt-hooks.gif)+[wt-hooks.gif]-<!-- TODO: Consider cutting or merging tweets 8-9. Reviewers noted:- - "50ms" is too technical / doesn't connect to AI workflows- - Fuzzy picker isn't differentiated (every CLI has one)- - Thread may be too long; these are weak candidates for cutting -->+**8/**+wt list renders in ~50ms, then fills in details (CI status, diff stats) as they become available. Can also list branches with wt list --branches.-**8/** (235 chars)-𝚠𝚝 𝚕𝚒𝚜𝚝 renders in ~50ms, then fills in details (CI status, diff stats) as they become available. Can also list branches with 𝚠𝚝 𝚕𝚒𝚜𝚝 --𝚋𝚛𝚊𝚗𝚌𝚑𝚎𝚜.+wt list --full: CI status as clickable dots. Green/blue/red. Clicking opens the PR.-𝚠𝚝 𝚕𝚒𝚜𝚝 --𝚏𝚞𝚕𝚕: CI status as clickable dots. Green/blue/red. Clicking opens the PR.+[wt-list.gif]-[wt-list.gif](../../../assets/social/light/wt-list.gif)+**9/**+wt select: fuzzy picker across all branches.-**9/** (45 chars)-𝚠𝚝 𝚜𝚎𝚕𝚎𝚌𝚝: fuzzy picker across all branches.+[wt-select-short.gif]-[wt-select-short.gif](../../../assets/social/light/wt-select-short.gif)+**10/**+LLM Commits: When running wt step commit or wt merge, worktrunk can have an LLM write the commit message, with a customizable template.-**10/** (99 chars)-LLM Commits: When running 𝚠𝚝 𝚜𝚝𝚎𝚙 𝚌𝚘𝚖𝚖𝚒𝚝 or 𝚠𝚝 𝚖𝚎𝚛𝚐𝚎, worktrunk can have an LLM write the commit message, with a customizable template.+[wt-commit.gif]-[wt-commit.gif](../../../assets/social/light/wt-commit.gif)+**11/**+wt merge: squash, rebase, merge, remove worktree, delete branch, in one command.-**11/** (78 chars)-𝚠𝚝 𝚖𝚎𝚛𝚐𝚎: squash, rebase, merge, remove worktree, delete branch, in one command.+[wt-merge.gif]-[wt-merge.gif](../../../assets/social/light/wt-merge.gif)+**12/**+.@claudeai status line integration. See branch, diff stats, CI status at a glance.-**12/** (83 chars)-@claudeai status line integration. See branch, diff stats, CI status at a glance.+[wt-statusline.gif]-[wt-statusline.gif](../../../assets/social/light/wt-statusline.gif)+**13/**+Putting it all together: parallel Claude Code agents in Zellij tabs, each in its own worktree. The full lifecycle: wt switch, wt list, wt select, wt merge.-**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/social/light/wt-zellij-omnibus.gif)--<!-- ============ PHASE 5: CTA ============ -->-<!-- Goal: Install instructions, docs, invite feedback, star -->--**14/** (167 chars)+**14/**To install:-𝚋𝚛𝚎𝚠 𝚒𝚗𝚜𝚝𝚊𝚕𝚕 𝚖𝚊𝚡-𝚜𝚒𝚡𝚝𝚢/𝚠𝚘𝚛𝚔𝚝𝚛𝚞𝚗𝚔/𝚠𝚝-𝚠𝚝 𝚌𝚘𝚗𝚏𝚒𝚐 𝚜𝚑𝚎𝚕𝚕 𝚒𝚗𝚜𝚝𝚊𝚕𝚕--Feedback welcome. Open an issue or reply here.+brew install max-sixty/worktrunk/wt+wt config shell install-⭐ https://github.com/max-sixty/worktrunk+Feedback very welcome. Open an issue or reply here.-**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, liking & RT-ing the first tweet helps spread the word.+[GitHub card: github.com/max-sixty/worktrunk]-[TODO: paste link to tweet 1]-----+**15/**+Big thanks to @AnthropicAI and the @claudeai team, including @bcherny @_catwu @alexalbert__, for building Claude Code. Worktrunk wouldn't exist without it 🙏-## Notes+If this was useful, staring the repo / liking / RT-ing the first tweet helps spread the word.-- **Monospace in tweets**: Twitter doesn't support code formatting. Options:- - Unicode monospace via [YayText](https://yaytext.com/monospace/): 𝚠𝚝 𝚜𝚠𝚒𝚝𝚌𝚑 -𝚌 𝚏𝚎𝚊𝚝- - Screenshots- - Plain text (the GIF shows commands anyway)-- **Social proof**: Cut for now, could add back in a later tweet+[Quote tweet of tweet 1]