diff --git a/.github/assets/demo.gif b/.github/assets/demo.gif
new file mode 100644
index 0000000..6f49a66
Binary files /dev/null and b/.github/assets/demo.gif differ
diff --git a/.github/assets/demo.tape b/.github/assets/demo.tape
index e69de29..8981b63 100644
--- a/.github/assets/demo.tape
+++ b/.github/assets/demo.tape
@@ -0,0 +1,41 @@
+Output ./.github/assets/demo.gif
+Require spilltea
+
+Set Shell "zsh"
+Set FontSize 32
+Set Width 1600
+Set Height 1900
+
+Type "spilltea"
+Sleep 800ms
+Enter
+Sleep 3s
+
+Down@800ms 2
+Up@800ms 1
+Enter@800ms 1
+
+Wait+Screen     /hadi.icu/
+Sleep 3s
+
+Ctrl+Y
+Sleep 3s
+
+Down@1.9 4
+Escape@1.3 1
+
+Ctrl+R
+Sleep 3s
+Type "e"
+Sleep 1s
+Escape
+Sleep 1s
+Type "s"
+Sleep 6s
+
+Type "1"
+Sleep 2s
+Type "f"
+Sleep 2s
+Type "2"
+Sleep 2s
diff --git a/README.md b/README.md
index e507dd8..5e28dd9 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,8 @@ Spilltea is a **terminal-native HTTP(S) interception proxy**. It sits between yo
 
 It is intentionally minimal. No Electron, no browser, no bloat. Just a fast, keyboard-driven tool that gets out of your way.
 
+<img alt="demo" src="./.github/assets/demo.gif" width="700" />
+
 ## Features
 
 - **Intercept**: Pause requests and responses in-flight. Inspect and modify them (even with your favorite editor) before forwarding.