diff --git a/docs/media/demo.md b/docs/media/demo.md
new file mode 100644
index 0000000..f524fa2
--- /dev/null
+++ b/docs/media/demo.md
@@ -0,0 +1,15 @@
+# Demo screenshot
+
+![patchorder demo output](demo.png)
+
+`demo.png` (1600x900) is the unedited terminal output of a real demo run, rendered to an image on 2026-11-03. All hosts, users, devices and files in it are fictional sample data that ships with this repository. No network service or real system was involved.
+
+Setup: python -m pip install -e ..
+
+Commands, in the order shown in the image:
+
+```text
+$ python -m patchorder demo | head -n 20
+```
+
+Pipes such as `head`, `grep` or `sed` in the commands above only shorten the output so it fits on one screen. They are part of the shown command.
diff --git a/docs/media/demo.png b/docs/media/demo.png
new file mode 100644
index 0000000..cfa8b8c
Binary files /dev/null and b/docs/media/demo.png differ