diff --git a/README.md b/README.md
index 88ad551..c819210 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,13 @@ history.
 to the Codeforces public API. Browser-only operations use either an isolated
 Chrome profile or the optional extension embedded in the `cfx` binary.
 
+## Demo
+
+[![cfx terminal workflow: search, start, test, and submit](docs/assets/cfx-demo.gif)](docs/assets/cfx-demo.mp4)
+
+Search for a problem, create a complete contest workspace, train with an agent,
+run local samples, and submit explicitly. [Open the full-resolution MP4](docs/assets/cfx-demo.mp4).
+
 ## Features
 
 - Sync and cache the public Codeforces problem and contest catalogs.
diff --git a/docs/assets/cfx-demo.gif b/docs/assets/cfx-demo.gif
new file mode 100644
index 0000000..3233e20
Binary files /dev/null and b/docs/assets/cfx-demo.gif differ
diff --git a/docs/assets/cfx-demo.mp4 b/docs/assets/cfx-demo.mp4
new file mode 100644
index 0000000..7eb6d8b
Binary files /dev/null and b/docs/assets/cfx-demo.mp4 differ