diff --git a/README.md b/README.md
index 2d361cb..c6eb8e4 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,12 @@ non-zero, never nags. The pet's face is the only feedback.
 npx gitgotchi
 ```
 
+## How to use — a 30-second tour
+
+<p align="center">
+  <img src="docs/usage.gif" alt="A walkthrough of the gitgotchi commands: check in, watch, how the repo drives the mood, and export a card" width="640" />
+</p>
+
 ## Contents
 
 - [Quick start](#quick-start)
diff --git a/docs/usage.gif b/docs/usage.gif
new file mode 100644
index 0000000..6cc6646
Binary files /dev/null and b/docs/usage.gif differ