diff --git a/README.md b/README.md
index 955490f..ac24c44 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,8 @@ npx @antomanc/aginit
 [![npm version](https://img.shields.io/npm/v/@antomanc/aginit)](https://www.npmjs.com/package/@antomanc/aginit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
+<p align="center"><img src="docs/assets/demo.gif" alt="aginit wizard creating a CLI project with AGENTS.md, skills and a Graft codebase graph" width="720"></p>
+
 > **Beta.** Expect flags and defaults to change before 1.0.
 
 ## Why
diff --git a/docs/assets/demo.gif b/docs/assets/demo.gif
new file mode 100644
index 0000000..085b220
Binary files /dev/null and b/docs/assets/demo.gif differ
diff --git a/docs/assets/demo.tape b/docs/assets/demo.tape
new file mode 100644
index 0000000..4bd09fa
--- /dev/null
+++ b/docs/assets/demo.tape
@@ -0,0 +1,54 @@
+# Hero GIF for the README. Regenerate with: vhs docs/assets/demo.tape
+# Needs vhs, ttyd and ffmpeg, a built dist/ (pnpm build) and network access for skills.sh.
+
+Output docs/assets/demo.gif
+
+Set Shell bash
+Set FontFamily "JetBrains Mono"
+Set FontSize 15
+Set LineHeight 1.15
+Set Width 1000
+Set Height 820
+Set Padding 24
+Set Theme "Catppuccin Mocha"
+Set TypingSpeed 60ms
+Set WindowBar Colorful
+
+# Tidy prompt; run the local build from a scratch directory.
+Hide
+Type `export AGINIT="$PWD/bin/aginit.js" && rm -rf /tmp/demo && mkdir /tmp/demo && cd /tmp/demo`
+Enter
+# npx @antomanc/aginit -> the local build (same code as the published release).
+Type `npx() { shift; node "$AGINIT" "$@"; }`
+Enter
+Type `export PS1='\[\e[32m\]antomanc@home-server\[\e[0m\]:\[\e[34m\]\w\[\e[0m\]$ '`
+Enter
+Type "clear"
+Enter
+Show
+
+Sleep 800ms
+Type "npx @antomanc/aginit"
+Sleep 400ms
+Enter
+Sleep 1.5s
+
+# What would you like to do? -> new project
+Enter
+Sleep 800ms
+Type "my-app"
+Sleep 500ms
+Enter
+Sleep 800ms
+# Preset: Web -> CLI Tool
+Down
+Sleep 500ms
+Enter
+Sleep 800ms
+# Package manager: pnpm
+Enter
+
+Sleep 20s
+Type "ls -A my-app"
+Enter
+Sleep 3s