Add a styled demo of one task going through the real runtime

README.md

@@ -10,6 +10,8 @@ Rust Agent Runtime executes automated coding tasks using language models while e
 > [!NOTE]
 > **Status:** Research prototype (pre-1.0; bounded execution; not a general security sandbox).
 
+![A coding task going through the runtime: a blocked command, a rejected early finish, then done](docs/demo/demo.gif)
+
 - Reconstructs task state from an append-only event log with restart recovery.
 - Runs allowlisted commands with timeouts, output caps, and process-group termination.
 - Routes model actions through the runtime rather than letting models execute directly.
@@ -28,6 +30,7 @@ cd rust-agent-runtime
 
 cargo build --locked
 cargo test --locked
+rust-agent-runtime demo
 ```
 
 ### Exercise task lifecycle (offline)

docs/demo/demo.tape

@@ -0,0 +1,24 @@
+Output docs/demo/demo.gif
+Set Shell "bash"
+Set FontSize 16
+Set Width 1200
+Set Height 470
+Set Padding 28
+Set Theme "Catppuccin Mocha"
+Hide
+Type `export PS1='$ ' PATH="$PWD/target/release:$PATH"`
+Enter
+Type `clear; printf '$ rust-agent-runtime demo\n'; RAR_DEMO_FAST=1 rust-agent-runtime demo`
+Enter
+Sleep 1s
+Show
+Sleep 4s
+Hide
+Type "clear"
+Enter
+Type "rust-agent-runtime demo"
+Show
+Sleep 600ms
+Enter
+Sleep 4s
+Sleep 5s