docs: add recorded hero.gif + reproducible vhs tape

- scripts/hero.tape: vhs script driving a 23s demo through 4 style/theme
  combos (classic/graphite, capsule/dracula, hairline/nord, classic/
  tokyo-night) using mock rate_limits JSON so it's deterministic.
- scripts/build-hero-gif.sh: wrapper that runs vhs and trims the first
  ~3.5s of vhs setup leakage (Hide directive isn't reliable in vhs 0.11),
  then re-quantizes the palette to keep the GIF under ~250KB.
- docs/images/hero.gif: 23s, 202KB, 1100x320 output.

For off-platform sharing (X / Reddit / PH); README continues to use the
3KB animated hero.svg for inline GitHub rendering.

Author: leeguooooo

docs/images/hero.gif

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Re-build docs/images/hero.gif from scripts/hero.tape.
+# Trims ~3.5s of vhs setup leakage and re-quantizes the palette.
+#
+# Deps: vhs (brew), ffmpeg (brew).
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/.." && pwd)"
+TAPE="$ROOT/scripts/hero.tape"
+OUT="$ROOT/docs/images/hero.gif"
+TMP="$(mktemp -d)"
+trap 'rm -rf "$TMP"' EXIT
+
+command -v vhs >/dev/null    || { echo "missing: vhs (brew install vhs)" >&2; exit 1; }
+command -v ffmpeg >/dev/null || { echo "missing: ffmpeg (brew install ffmpeg)" >&2; exit 1; }
+
+echo "[1/2] vhs render..."
+vhs "$TAPE"   # writes to $OUT per the tape's `Output` directive
+
+echo "[2/2] ffmpeg trim + re-quantize..."
+ffmpeg -y -loglevel warning \
+  -ss 3.5 -i "$OUT" \
+  -vf "fps=15,split[a][b];[a]palettegen=stats_mode=full[p];[b][p]paletteuse=dither=bayer:bayer_scale=5" \
+  -f gif "$TMP/hero.gif"
+
+mv "$TMP/hero.gif" "$OUT"
+
+dur=$(ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 "$OUT")
+size=$(ls -lh "$OUT" | awk '{print $5}')
+echo "wrote $OUT  (${dur}s, $size)"

scripts/build-hero-gif.sh

@@ -0,0 +1,63 @@
+# vhs tape for the hero GIF.
+# Usage:  brew install vhs  &&  vhs scripts/hero.tape
+# Output: docs/images/hero.gif
+#
+# The demo feeds mock rate_limits JSON to `cs` so the bar shows believable
+# numbers regardless of where you run it. No mutation of your real config.
+
+Output docs/images/hero.gif
+
+Set Shell "bash"
+Set FontSize 18
+Set FontFamily "JetBrainsMono Nerd Font Mono,Menlo,monospace"
+Set Width 1100
+Set Height 320
+Set Padding 24
+Set Theme "Dracula"
+Set Framerate 30
+Set PlaybackSpeed 1.0
+Set TypingSpeed 35ms
+
+# ---- Setup invisible: clean prompt + define the mock JSON in $J ----
+Hide
+Type "export PS1='$ '"
+Enter
+Type `J='{"session_id":"demo","model":{"display_name":"Opus 4.7"},"rate_limits":{"five_hour":{"used_percentage":58,"resets_at":'$(($(date +%s)+10020))',"status":"allow"},"seven_day":{"used_percentage":24,"resets_at":'$(($(date +%s)+304320))',"status":"allow"}}}'`
+Enter
+Type "clear"
+Enter
+Sleep 300ms
+Show
+
+# ---- Pitch line ----
+Type "# Claude Code rate-limit usage, in your statusLine"
+Enter
+Sleep 1.2s
+Type "# 3 styles × 9 themes — let's try a few:"
+Enter
+Sleep 1.2s
+
+# ---- 1) classic / graphite ----
+Type "echo $J | cs --style classic --theme graphite"
+Enter
+Sleep 2.2s
+
+# ---- 2) capsule / dracula ----
+Type "echo $J | cs --style capsule --theme dracula"
+Enter
+Sleep 2.2s
+
+# ---- 3) hairline / nord ----
+Type "echo $J | cs --style hairline --theme nord"
+Enter
+Sleep 2.2s
+
+# ---- 4) classic / tokyo-night ----
+Type "echo $J | cs --style classic --theme tokyo-night"
+Enter
+Sleep 2.5s
+
+# ---- 5) call to action ----
+Type "# pip install claude-statusbar && cs --setup"
+Enter
+Sleep 3s