update instructions

1 files changed, 7 insertions, 0 deletions

diff --git a/AGENTS.md b/AGENTS.md
index ddfdbbf..0d65300 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -25,8 +25,15 @@ env GOTOOLCHAIN=auto mage bench        # Run benchmarks
 env GOTOOLCHAIN=auto mage prReview     # Run PR review baseline: world + benchProf
 env GOTOOLCHAIN=auto mage clean        # Clean build artifacts
 env GOTOOLCHAIN=auto mage world        # Clean + generate + test + build (recommended reset path)
+env GOTOOLCHAIN=auto mage demo         # Regen demo/ GIFs + screenshots (needs vhs+ttyd, sudo -v warmed)
+TAPE=07-stream-live mage demoOne       # Regen one demo tape only
+env GOTOOLCHAIN=auto mage installDemoTools  # One-time: install vhs (go install) and ttyd (dnf)
 ```
 
+## Demo Pipeline
+
+`demo/` holds the reproducible TUI demo: 14 [VHS](https://github.com/charmbracelet/vhs) `.tape` files under `demo/tapes/` drive every dashboard tab and headless mode, write GIFs and PNGs into `demo/assets/`, and the resulting tutorial is `demo/TUTORIAL.md`. Background workload is generated by `demo/scripts/workload.sh`. `mage demo` is fully headless (no real terminal window) — safe to run in the background while editing code; the only foreground requirement is one `sudo -v` to pre-warm the sudo timestamp.
+
 ## Code Generation
 
 **Run `mage generate` before building when tracepoint definitions change!**