diff --git a/README.md b/README.md
index 0770bc7..db8c4e7 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,9 @@ Features:
 - history
 - comments (comment character is `#`)
 
+## Demo
+
+![asciicast](demo/demo.gif)
 
 ## Working principle
 
diff --git a/demo/Makefile b/demo/Makefile
new file mode 100644
index 0000000..53d6e2a
--- /dev/null
+++ b/demo/Makefile
@@ -0,0 +1,7 @@
+#
+
+
+all:
+	asciinema rec --cols 80 --row 25 -c "env - PS1='> ' PATH=..:$PATH /bin/bash --norc --noprofile" --overwrite demo.cast
+	agg demo.cast demo.gif
+
diff --git a/demo/demo.cast b/demo/demo.cast
new file mode 100644
index 0000000..438a0d8
--- /dev/null
+++ b/demo/demo.cast
@@ -0,0 +1,3 @@
+{"version": 2, "width": 80, "height": 25, "timestamp": 1699358215, "env": {"SHELL": "/bin/bash", "TERM": "tmux-256color"}}
+[0.005628, "o", "> "]
+[0.941195, "o", "exit\r\n"]
diff --git a/demo/demo.gif b/demo/demo.gif
new file mode 100644
index 0000000..6db29de
Binary files /dev/null and b/demo/demo.gif differ
diff --git a/demo/sessions.txt b/demo/sessions.txt
new file mode 100644
index 0000000..ce551e9
--- /dev/null
+++ b/demo/sessions.txt
@@ -0,0 +1,18 @@
+# demo sessions, used to create an interactive rpn recording
+
+# part 1: interactive
+
+# put some numbers onto the stack
+2 4 6
+8
+10
+
+# take a look at the stack
+dump
+
+# add the last 2
++
+
+# multiply the result and the previous
+*
+