diff --git a/README.md b/README.md
index ec850f094..6b143be11 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,9 @@
 
 **🔥 Active Development • New Features Weekly 🔥**
 
-![ClawCodex Screenshot](assets/clawcodex-screenshot-1.png)
+![ClawCodex web UI demo](assets/clawcodex-web-demo.gif)
+
+<sub>A 30-second session in the web UI (`clawcodex web`): ask for a feature, watch it read, edit, run the tests, and report. [MP4 version](assets/clawcodex-web-demo.mp4)</sub>
 
 </div>
 
diff --git a/assets/clawcodex-web-demo.gif b/assets/clawcodex-web-demo.gif
new file mode 100644
index 000000000..d6187eb1c
Binary files /dev/null and b/assets/clawcodex-web-demo.gif differ
diff --git a/assets/clawcodex-web-demo.mp4 b/assets/clawcodex-web-demo.mp4
new file mode 100644
index 000000000..bc5afb1c9
Binary files /dev/null and b/assets/clawcodex-web-demo.mp4 differ