diff --git a/README.md b/README.md
index f6d43ea..ea880a4 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,16 @@
 
 Documentation is almost always outdated or non-existent. **DocBot** solves this by autonomously mapping your system architecture in seconds, not days. It parallelizes codebase exploration using specialized agents to extract deep semantic understanding—from high-level components to individual symbols.
 
+## Demo
+
+https://github.com/user-attachments/assets/8ae00195-222e-4a96-8ce2-abe5e41596d7
+
+DocBot steps through a repository with explanations and links to source files.
+This 22-second guided-tour excerpt retains the original audio from the team's
+demo, uploaded by Ricky Tang. The
+[full video](https://www.youtube.com/watch?v=LN9GxjALn_Q) also covers the dashboard,
+file browser, architecture graph, and diff view.
+
 ## Features
 
 - **Interactive Architecture Maps**: Dynamically renders a whiteboard-style graph of your entire system that you can actually chat with.