diff --git a/README.md b/README.md
index 08a3653..f58f330 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,11 @@
 # Overnight Local-LLM Paper-Trading Agent
 
+<p align="center">
+  <a href="docs/demo.mp4"><img src="docs/demo.gif" alt="Dashboard tour: portfolio, agent theses, AI committee verdicts, orders" width="820"></a>
+  <br>
+  <em>▶ Dashboard tour — portfolio &amp; option positions, each persona's overnight theses, the AI Investment Committee verdicts, and the orders that got placed. <a href="docs/demo.mp4">Click for the full-quality MP4 (with sound).</a></em>
+</p>
+
 Every night the Mac wakes itself, runs **4 trader personas** one at a time against **one local LLM**
 (gpt-oss-20b via [oMLX](https://omlx.ai), an Apple-MLX inference server). Each persona researches the
 web + live market data, forms up to **4 trade theses — at least one of them an options trade** —
diff --git a/docs/demo.gif b/docs/demo.gif
new file mode 100644
index 0000000..fcb2c83
Binary files /dev/null and b/docs/demo.gif differ
diff --git a/docs/demo.mp4 b/docs/demo.mp4
new file mode 100644
index 0000000..12afcb4
Binary files /dev/null and b/docs/demo.mp4 differ