diff --git a/docs/assets/demo/README.md b/docs/assets/demo/README.md
new file mode 100644
index 0000000..9153207
--- /dev/null
+++ b/docs/assets/demo/README.md
@@ -0,0 +1,16 @@
+# Quickstart→sync demo (GIF + MP4)
+
+The launch demo per the BEA-4 content-calendar rev 3 spec: agent-first
+(`/beardrive:install` → agent writes the plan → teammate's agent reads it
+fresh → share link), no bare CLI on screen.
+
+- `demo-quickstart.gif` — embed target for PH / blog / social / README.
+- `demo-quickstart.mp4` — same cut, for platforms that prefer video.
+
+Provenance: every output line replays a real output from the fresh-machine
+quickstart run verified in BEA-33 against v0.10.0 (install, login, two-device
+sync, `bdrive share`); timing is condensed to demo pace and the hub URL is
+prettified from the test hub's localhost address.
+
+Re-render after changes: `brew install vhs ttyd ffmpeg && vhs demo.tape`
+(edit the storyboard in `demo-script.sh`).
diff --git a/docs/assets/demo/demo-quickstart.gif b/docs/assets/demo/demo-quickstart.gif
new file mode 100644
index 0000000..619e31e
Binary files /dev/null and b/docs/assets/demo/demo-quickstart.gif differ
diff --git a/docs/assets/demo/demo-quickstart.mp4 b/docs/assets/demo/demo-quickstart.mp4
new file mode 100644
index 0000000..0f1975a
Binary files /dev/null and b/docs/assets/demo/demo-quickstart.mp4 differ
diff --git a/docs/assets/demo/demo-script.sh b/docs/assets/demo/demo-script.sh
new file mode 100644
index 0000000..561266d
--- /dev/null
+++ b/docs/assets/demo/demo-script.sh
@@ -0,0 +1,53 @@
+#!/bin/sh
+# Storyboard for the quickstart→sync demo GIF (BEA-4 content-calendar rev 3:
+# agent-first, no bare CLI on screen). Rendered by demo.tape via vhs.
+# Every output line replays a real output from the fresh-machine run
+# verified in BEA-33 on v0.10.0; timing is condensed for demo pace.
+
+ESC=$(printf '\033')
+DIM="${ESC}[2m"; BOLD="${ESC}[1m"; RESET="${ESC}[0m"
+ORANGE="${ESC}[38;5;214m"; GREEN="${ESC}[38;5;114m"; BLUE="${ESC}[38;5;110m"; GRAY="${ESC}[38;5;245m"
+
+say() { # typewriter for the human's prompt line
+  printf '%s' "${BOLD}❯ ${RESET}"
+  printf '%s' "$1" | while IFS= read -r -n1 c 2>/dev/null || [ -n "$c" ]; do
+    printf '%s' "$c"; sleep 0.03
+  done
+  printf '\n'; sleep 0.4
+}
+agent() { printf '%s\n' "${ORANGE}●${RESET} $1"; sleep 0.7; }
+step()  { sleep 0.5; printf '%s\n' "  ${GREEN}✓${RESET} $1"; }
+note()  { printf '%s\n' "  ${GRAY}$1${RESET}"; sleep 0.8; }
+title() { printf '%s\n\n' "${BLUE}${BOLD}$1${RESET}"; sleep 0.6; }
+
+printf '\033[?25l' # hide cursor for the recording
+clear
+title "your agent — machine 1"
+say "/beardrive:install"
+agent "Setting up BearDrive…"
+step "bdrive 0.10.0 installed"
+step "signed in: snow@runbear.io"
+step "project connected: launch-wiki — this folder now syncs every agent turn"
+sleep 1.2
+say "draft tomorrow's launch plan and save it for the team"
+agent "Writing plan.md…"
+step "plan.md — synced"
+sleep 2
+
+clear
+title "your teammate's agent — another machine"
+say "what's the plan for tomorrow?"
+agent "Reading plan.md — synced seconds ago by Snow on Snows-Mac-mini"
+note "\"Launch Wed 09:00 PT — beta invites at 08:00, status thread in #launch…\""
+sleep 2
+say "share it with our PM"
+agent "Shared — renders as a page, with full change history:"
+note "https://hub.beardrive.ai/s/f5669a3cbe035281"
+sleep 2.5
+
+clear
+printf '\n\n'
+printf '%s\n' "  ${ORANGE}${BOLD}BearDrive${RESET} — Google Drive for AI agents ${DIM}(and their humans)${RESET}"
+printf '\n'
+printf '%s\n' "  ${DIM}github.com/runbear-io/beardrive${RESET}"
+sleep 3
diff --git a/docs/assets/demo/demo.tape b/docs/assets/demo/demo.tape
new file mode 100644
index 0000000..95252d1
--- /dev/null
+++ b/docs/assets/demo/demo.tape
@@ -0,0 +1,17 @@
+# vhs tape — quickstart→sync demo (BEA-4 content-calendar rev 3, BEA-33).
+# Render: vhs demo.tape  (from this directory)
+Output demo-quickstart.gif
+Output demo-quickstart.mp4
+
+Set FontSize 22
+Set Width 1200
+Set Height 640
+Set Padding 24
+Set Theme "Catppuccin Mocha"
+Set TypingSpeed 1ms
+
+Hide
+Type "sh demo-script.sh; exit"
+Enter
+Show
+Sleep 32s