diff --git a/README.md b/README.md
index c8eadda0..e91853d9 100644
--- a/README.md
+++ b/README.md
@@ -1025,6 +1025,18 @@ semantica        # startup dashboard
 semantica --help # full grouped command reference
 ```
 
+<div align="center">
+
+<img
+  src="docs/assets/img/semantica-cli-demo.gif"
+  alt="Semantica CLI startup dashboard, health checks, graph build, shell, and grouped commands"
+  width="900"
+/>
+
+</div>
+
+Start with `semantica`, verify with `doctor`, build a graph, and explore the command groups from one terminal.
+
 ### Startup Dashboard
 
 ```
diff --git a/docs/assets/img/semantica-cli-demo.gif b/docs/assets/img/semantica-cli-demo.gif
new file mode 100644
index 00000000..db519f05
Binary files /dev/null and b/docs/assets/img/semantica-cli-demo.gif differ