docs: re-record GIFs with vhs, add shell integration to demo

- Switch from shellwright to vhs for GIF recording (proper timing)
- Add vhs tape files for all 5 demos (quickstart, create, hooks, multi-repo, info)
- Enable shell integration in Docker image so prompt updates after wt co
- Clean up README: remove duplications, better structure

Author: timvw

README.md

@@ -123,7 +123,6 @@ eval "$(wt shellenv)"
 
 **Note for zsh users:** Place this after `compinit` in your config file.
 
-
 ## Usage
 
 ### Checkout & Create
@@ -164,12 +163,15 @@ wt rm old-branch                  # remove a worktree
 wt rm                             # interactive: select worktree to remove
 ```
 
-### Maintenance
+### Maintenance & Misc
 
 ```bash
 wt migrate                        # migrate worktrees to configured paths
 wt migrate --force                # force when target path exists
 wt prune                          # clean up stale worktree admin files
+wt version                        # show version
+wt examples                       # show practical examples
+wt --help                         # show help
 ```
 
 ### Info & Config
@@ -183,110 +185,34 @@ wt config init                    # create a default config file
 wt config path                    # print the config file path
 ```
 
-### Shell Integration & Misc
-
-```bash
-wt init                           # auto-detect shell and configure
-wt init --uninstall               # remove shell integration
-wt shellenv                       # print shell integration code
-wt version                        # show version
-wt examples                       # show practical examples
-wt --help                         # show help
-```
-
-### JSON Output (`--format json`)
-
-Most commands support machine-readable JSON output:
-
-```bash
-wt --format json version
-wt --format json info
-wt --format json config show
-wt --format json list
-wt --format json examples
-wt --format json          # root help in JSON envelope
-```
-
-Important behavior for shell integration:
-
-- In `text` mode (default), shell integration may auto-navigate to the target worktree.
-- In `json` mode, output is kept machine-readable and shell integration does **not** auto-navigate.
-
-For commands that normally prompt interactively (`wt co`, `wt rm`, `wt pr`, `wt mr`), pass explicit arguments when using `--format json`.
-
 ### Interactive Selection
 
 When you run `wt co`, `wt rm`, `wt pr`, or `wt mr` without arguments, you'll get an interactive selection menu:
 
 ```bash
-# Interactive branch checkout
 $ wt co
 Use the arrow keys to navigate: ↓ ↑ → ←
 ? Select branch to checkout:
   ▸ feature/add-auth
     feature/update-docs
     bugfix/login-issue
     main
-
-# Interactive worktree removal
-$ wt rm
-Use the arrow keys to navigate: ↓ ↑ → ←
-? Select worktree to remove:
-  ▸ feature/add-auth
-    feature/update-docs
-    bugfix/login-issue
-
-# Interactive PR checkout — resolves to the PR's branch name (requires gh CLI)
-$ wt pr
-Use the arrow keys to navigate: ↓ ↑ → ←
-? Select Pull Request:
-  ▸ #123: Add authentication feature
-    #124: Update documentation
-    #125: Fix login bug
-# e.g. selecting #123 creates worktree at ~/dev/worktrees/<repo>/feat/add-auth
-
-# Interactive MR checkout — resolves to the MR's branch name (requires glab CLI)
-$ wt mr
-Use the arrow keys to navigate: ↓ ↑ → ←
-? Select Merge Request:
-  ▸ !456: Add authentication feature
-    !457: Update documentation
-    !458: Fix login bug
-# e.g. selecting !456 creates worktree at ~/dev/worktrees/<repo>/feat/add-auth
 ```
 
-### Examples
-
-```bash
-# Create a new feature branch from main
-wt create add-auth-feature
-
-# Checkout an existing branch
-wt checkout bugfix-login
-
-# Work on a GitHub PR (checks out the PR's branch, e.g. feat/add-auth)
-wt pr 456
-
-# Work on a GitLab MR (checks out the MR's branch, e.g. fix/api-cleanup)
-wt mr 789
-
-# List all your worktrees
-wt list
-
-# Remove a worktree when done
-wt rm add-auth-feature
-
-# Show full examples catalog (filter with rg/grep if needed)
-wt examples
+### JSON Output (`--format json`)
 
-# Each example includes outcome + path illustration based on config pattern
-# e.g. path example: $WORKTREE_ROOT/<repo>/<branch> -> (removed)
-# and concrete text/json output samples where relevant
+Most commands support machine-readable JSON output:
 
-# JSON mode does not auto-navigate; use returned navigate_to
-wt --format json create add-auth-feature
+```bash
+wt --format json version
+wt --format json info
+wt --format json config show
+wt --format json list
+wt --format json examples
 ```
 
+In `json` mode, shell integration does **not** auto-navigate. For commands that normally prompt interactively, pass explicit arguments when using `--format json`.
+
 ## Configuration
 
 ### Configuration File
@@ -334,17 +260,10 @@ Configuration values are resolved in this order (highest priority first):
 
 Run `wt config show` to see the effective value and source of each setting.
 
-### Worktree Location
+### Strategies & Patterns
 
 By default, worktrees are created at `~/dev/worktrees/<repo>/{.branch}` using the `global` strategy.
 
-Configure the location with environment variables or the config file:
-
-- `WORKTREE_ROOT` / `root` (default: `~/dev/worktrees`)
-- `WORKTREE_STRATEGY` / `strategy` (`global`, `sibling-repo`, `parent-branches`, `parent-worktrees`, `parent-dotdir`, `inside-dotdir`, `custom`)
-- `WORKTREE_PATTERN` / `pattern` (optional; overrides the default structure within the chosen strategy)
-- `WORKTREE_SEPARATOR` / `separator` (default: `/`; controls how `/` and `\` in value variables are replaced)
-
 Available pattern variables:
 
 - `{.repo.Name}` repo name
@@ -378,49 +297,12 @@ The `separator` setting controls how `/` and `\` characters in **value variables
 | `_` | `feat_foo` (flat) | Alternative flat layout |
 | `""` | `featfoo` | Compact (rarely used) |
 
-```toml
-# ~/.config/wt/config.toml
-separator = "-"   # feat/foo -> feat-foo
-```
-
-```bash
-export WORKTREE_SEPARATOR="-"
-```
-
-Customize the location via environment variables:
-
-```bash
-export WORKTREE_ROOT="$HOME/projects/worktrees"
-export WORKTREE_STRATEGY="sibling-repo"
-export WORKTREE_SEPARATOR="-"
-export WORKTREE_PATTERN="{.repo.Main}/../{.repo.Name}/{.branch}"
-```
-
-Or via config file:
-
-```toml
-root = "~/projects/worktrees"
-strategy = "sibling-repo"
-separator = "-"
-pattern = "{.repo.Main}/../{.repo.Name}/{.branch}"
-```
-
-Run `wt info` to see the active strategy, pattern, and available variables.
-
 ### Hooks
 
 Hooks let you run custom commands before or after `wt` operations. Define them in the `[hooks]` section of your config file:
 
 ![wt hooks](docs/wt-hooks.gif)
 
-```toml
-# ~/.config/wt/config.toml
-[hooks]
-post_create = ["test -f $WT_MAIN/.env && cp $WT_MAIN/.env $WT_PATH/.env || true"]
-post_checkout = ["cd $WT_PATH && npm install"]
-pre_remove = ["echo Removing worktree at $WT_PATH"]
-```
-
 **Available hooks:**
 
 | Hook | When it runs |
@@ -506,32 +388,9 @@ strategy = "custom"
 pattern = "{.worktreeRoot}/{.env.FEATURE}/{.repo.Name}"
 ```
 
-Set the `FEATURE` environment variable and create worktrees across repos:
-
 ```bash
 export FEATURE=PROJ-42-new-checkout
 
-cd ~/src/frontend
-wt create main        # any branch name works; layout is driven by FEATURE
-
-cd ~/src/backend
-wt create main
-```
-
-This groups all repositories for a feature together:
-
-```
-~/dev/worktrees/
-  PROJ-42-new-checkout/
-    frontend/
-    backend/
-```
-
-Switch to a different feature by changing the variable:
-
-```bash
-export FEATURE=PROJ-99-hotfix
-
 cd ~/src/frontend
 wt create main
 
@@ -544,9 +403,6 @@ wt create main
   PROJ-42-new-checkout/
     frontend/
     backend/
-  PROJ-99-hotfix/
-    frontend/
-    backend/
 ```
 
 If the referenced environment variable is not set, `wt` will return an error.
@@ -604,16 +460,6 @@ The tool wraps Git's native worktree commands with a convenient interface and or
 4. **Auto-CD**: With shell integration, automatically changes to the worktree directory
 5. **Tab Completion**: Makes it easy to work with existing branches
 
-## Comparison with Original
-
-This Go port maintains feature parity with the original bash script while offering:
-
-- Faster execution (compiled binary)
-- No bash dependency
-- Easier to distribute (single binary)
-- Cross-platform support (builds on Windows, macOS, Linux)
-- Built-in completion support via cobra
-
 ## License
 
 MIT

docs/demo/Dockerfile

@@ -44,7 +44,7 @@ error_symbol = "[❯](bold red)"\n\
 ' > .config/starship.toml
 
 # Bake starship init into .bashrc so it activates even with bare bash
-RUN printf 'eval "$(starship init bash)"\n' > .bashrc
+RUN printf 'eval "$(starship init bash)"\neval "$(wt shellenv)"\n' > .bashrc
 
 # Create main-app repo with branches and .env
 RUN mkdir -p src/main-app && cd src/main-app && git init && \

docs/demo/create.tape

@@ -0,0 +1,38 @@
+Output "../wt-create.gif"
+
+Set Theme "Dracula"
+Set FontSize 16
+Set Width 1200
+Set Height 600
+Set TypingSpeed 30ms
+Set Padding 20
+
+Hide
+Type "docker run --rm -it -e WORKTREE_ROOT=/home/demo/worktrees wt-demo bash --rcfile /home/demo/.bashrc"
+Enter
+Sleep 3s
+Type "cd src/main-app"
+Enter
+Sleep 1s
+Type "clear"
+Enter
+Sleep 1s
+Show
+
+Type "wt create feat/new-feature"
+Enter
+Sleep 4s
+
+Type "wt ls"
+Enter
+Sleep 6s
+
+Type "wt rm feat/new-feature"
+Enter
+Sleep 4s
+
+Type "wt ls"
+Enter
+Sleep 6s
+
+Sleep 5s

docs/demo/hooks.tape

@@ -0,0 +1,34 @@
+Output "../wt-hooks.gif"
+
+Set Theme "Dracula"
+Set FontSize 16
+Set Width 1200
+Set Height 600
+Set TypingSpeed 30ms
+Set Padding 20
+
+Hide
+Type "docker run --rm -it -e WORKTREE_ROOT=/home/demo/worktrees -e WT_CONFIG=/home/demo/.config/wt/variants/hooks.toml wt-demo bash --rcfile /home/demo/.bashrc"
+Enter
+Sleep 3s
+Type "cd src/main-app"
+Enter
+Sleep 1s
+Type "clear"
+Enter
+Sleep 1s
+Show
+
+Type "cat .env"
+Enter
+Sleep 4s
+
+Type "wt co fix/login-bug"
+Enter
+Sleep 4s
+
+Type "cat ~/worktrees/main-app/fix/login-bug/.env"
+Enter
+Sleep 6s
+
+Sleep 5s

docs/demo/info.tape

@@ -0,0 +1,30 @@
+Output "../wt-info.gif"
+
+Set Theme "Dracula"
+Set FontSize 16
+Set Width 1200
+Set Height 600
+Set TypingSpeed 30ms
+Set Padding 20
+
+Hide
+Type "docker run --rm -it -e WORKTREE_ROOT=/home/demo/worktrees wt-demo bash --rcfile /home/demo/.bashrc"
+Enter
+Sleep 3s
+Type "cd src/main-app"
+Enter
+Sleep 1s
+Type "clear"
+Enter
+Sleep 1s
+Show
+
+Type "wt info"
+Enter
+Sleep 5s
+
+Type "wt config show"
+Enter
+Sleep 6s
+
+Sleep 5s