diff --git a/doc/demo.md b/doc/demo.md
new file mode 100644
index 0000000..ae41be3
--- /dev/null
+++ b/doc/demo.md
@@ -0,0 +1,52 @@
+# DEMO
+
+## MIAOU-BASH
+
+* log in trixie1 as pvincent
+  * ghostty interference
+    * no color => grep, ...
+    * delete does not work
+  * poor Readline
+    * ALT+.. does nothing
+    * SHIFT+.. does nothing
+  * poor vim
+* SO let's install miaou-bash
+  * easy install/version/self-upgrade/uninstall
+  * ghostty OK (delete,...)
+  * Readline
+    * up, down, ...
+  * nice prompt
+  * aliases (ll, la, ltr, sudo)
+* vim
+  * nicer, linenumber
+  * ctrl+s, ctrl+q
+  * readline compliant
+  * azerty
+
+## miaou-bash
+
+* MIAOU-BASH package interaction
+  * --help
+  * completion
+  * script..
+* write basic Bash script
+  * return => does not stop
+    * set -e
+  * unbound variable => no error
+    * set -u
+* call `miaou-bash` on same script
+  * no more need for `set -eu`
+  * stacktrace, color, hint, ...
+* shebang
+  * #!/usr/bin/miaou-bash
+  * #!/usr/bin/env miaou-bash
+* /opt/miaou-bash/test/miaou-bash.test.bash
+  * bash /opt/miaou-bash/test/stub/scenario.bash subshell_term
+  * bash -eu /opt/miaou-bash/test/stub/scenario.bash exit
+  * MIAOU-DEBUG=true ...
+* virtual file descriptor
+  * stdout, sterr
+    * order change
+  * miaou
+* 3 modes: system development hosted (miaou-incus, miaou-proxmox)
+  * miaou-incus