diff --git a/README.md b/README.md
index cd933f838..afaa15c7a 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,10 @@ headroom learn --all --apply     # Learn across all your projects
 
 Reads your conversation history, finds every failed tool call, correlates it with what eventually succeeded, and writes specific corrections into your project files. Next session starts smarter. **[Learn docs](docs/learn.md)**
 
+<p align="center">
+  <img src="headroom_learn.gif" alt="headroom learn demo" width="800">
+</p>
+
 ### Python: One function
 
 ```python
diff --git a/headroom_learn.gif b/headroom_learn.gif
new file mode 100644
index 000000000..0f562a8b4
Binary files /dev/null and b/headroom_learn.gif differ