diff --git a/demo.gif b/demo.gif
new file mode 100644
index 0000000..af1464c
Binary files /dev/null and b/demo.gif differ
diff --git a/demo.tape b/demo.tape
new file mode 100644
index 0000000..85b086d
--- /dev/null
+++ b/demo.tape
@@ -0,0 +1,30 @@
+Output demo.gif
+
+Require time
+Require cai
+
+Set Shell "bash"
+Set FontSize 18
+Set Width 1024
+Set Height 768
+Set TypingSpeed 0.1
+Set Framerate 24
+
+
+Type "# This is a realtime demo of `cai`"
+Sleep 500ms
+Enter
+
+Type "# Prompts often finish in less than 1 second! 🚀"
+Sleep 800ms
+Enter
+
+Type "time cai list fast CLI tools"
+Sleep 500ms
+Enter
+Sleep 5s
+
+Type "time cai how to write simple CLI tool in Rust | mdcat | head -n 24"
+Sleep 500ms
+Enter
+Sleep 15s
diff --git a/makefile b/makefile
index 10fb0e5..a014902 100644
--- a/makefile
+++ b/makefile
@@ -3,6 +3,10 @@ help: makefile
 	@tail -n +4 makefile | grep ".PHONY"
 
 
+demo.gif: demo.tape
+	vhs $<
+
+
 .PHONY: test
 test:
 	cargo test -- --show-output
diff --git a/readme.md b/readme.md
index 00986ef..83330a0 100644
--- a/readme.md
+++ b/readme.md
@@ -4,6 +4,8 @@
 - Finishing often in **less than 1 second**. 🚀
 - Build with Rust 🦀 and [Groq] for supreme performance and speed! 🏎️
 
+![`cai` demo](./demo.gif)
+
 
 ## Installation