diff --git a/README.md b/README.md
index 01ca354a9..c5c882739 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 > agents with specialized capabilities and tools, and the interactions between
 > agents.
 
-![cagent in action](docs/assets/cagent-run.gif)
+![cagent in action](docs/demo.gif)
 
 ## ✨ What is `cagent`? ✨
 
diff --git a/Taskfile.yml b/Taskfile.yml
index 032171bb7..06963d5f9 100644
--- a/Taskfile.yml
+++ b/Taskfile.yml
@@ -92,3 +92,7 @@ tasks:
         vars: { AGENT: 'gopher' }
       - task: push-agent
         vars: { AGENT: 'mem' }
+
+  record-demo:
+    desc: Record demo gif
+    cmd: vhs ./docs/demo.tape
\ No newline at end of file
diff --git a/docs/demo.gif b/docs/demo.gif
new file mode 100644
index 000000000..d04c13854
Binary files /dev/null and b/docs/demo.gif differ
diff --git a/docs/demo.tape b/docs/demo.tape
new file mode 100644
index 000000000..02815aed9
--- /dev/null
+++ b/docs/demo.tape
@@ -0,0 +1,30 @@
+# Requires https://github.com/rumpl/vhs/tree/screen-settled
+# and brew install ffmpeg ttyd
+
+Output docs/demo.gif
+
+Require cagent
+
+Set Shell "zsh"
+Set FontSize 24
+Set Width 1800
+Set Height 1000
+Set PlaybackSpeed 2
+Set Padding 0
+
+Type "cagent run ./examples/gopher.yaml" Sleep 3s Enter
+Sleep 1s
+
+Type "Run my non e2e tests and show me a table of the top 10 slowest." Sleep 1s Enter
+
+Wait+Screen     /allow this tool call/
+Sleep 1s
+Type "A"
+
+Sleep 1s WaitScreenSettled 1s Sleep 1s
+
+Type "Now, look at the slowest test and optimize it." Sleep 1s Enter
+
+Sleep 1s WaitScreenSettled 1s Sleep 1s
+
+Sleep 20s
\ No newline at end of file