2 +description: Create or refine an interactive Pi demo driver and GIF recording workflow
3 +argument-hint: "<
extension-or-demo-name>"
5 +Create/refine demo driver for `$ARGUMENTS`.
7 +Goal: animated GIF only. No screenshot. Use asciinema + pexpect + agg.
10 +- Manual workflow only; never run from check/release gates.
11 +- Driver files live in `drivers/*.py`; readable, small, commentable.
12 +- `scripts/demo.py` is engine; drivers contain data/steps only.
13 +- `just demo <name>` delegates to `python3 scripts/demo.py <name>`.
14 +- README missing → fail. Do not create README silently.
15 +- Assets land in each target extension: `agent/extensions/<target>/assets/<demo>.gif`.
16 +- README updated only between markers:
17 + `<!-- demo:<name>:start -->` … `<!-- demo:<name>:end -->`.
18 +- No screenshots. GIF is source of truth for visual QA.
23 +- theme: Pi default; do not force `--theme dark`.
24 +- cwd: choose demo-friendly extension/project dir.
25 +- Pi isolation flags:
26 + `--no-session --no-context-files --no-skills --no-prompt-templates --no-extensions`
27 +- Load exact extensions with `-e ./agent/extensions/<name>`.
28 +- For footer concert demos, load footer + client extensions together; do not make ephemeral fixture extensions.
29 +- Real LLM/quota calls OK for manual demos.
32 +- Spawn real interactive `pi` in PTY with fixed dimensions.
33 +- Actively pump child output to stdout; sleeping alone records empty casts.
34 +- Type commands/prompts char-by-char with deliberate delay so GIF shows typing.
35 +- Pause before Enter.
36 +- Use longer holds for human readability.
37 +- Modifiers/key overlays: skip unless Pi visibly reacts; asciinema has no native modifier overlay here.
39 +Good pacing baseline:
41 +- command typing delay: ~55–75ms/char
42 +- prompt typing delay: ~35–55ms/char
43 +- post `/quota`: 6–7s
44 +- post `/footer` hide: 4s
45 +- post `/footer` show: 5–6s
46 +- LLM prompt wait: 14–18s or until clear final output if reliable
50 +- record with `--headless --overwrite --capture-input --window-size 100x28 -i 4.0`
51 +- output `.demo/<name>.cast`
54 +- render GIF from cast:
55 + `agg --cols 100 --rows 28 --theme asciinema --text-font-family "JetBrains Mono" --font-size 14 --line-height 1.25 --idle-time-limit 4.0 --last-frame-duration 5 --fps-cap 24 <cast> <gif>`
58 +- Inspect GIF, not `.txt`, as visual truth.
59 +- Also generate text for quick sanity:
60 + `asciinema convert -f txt <cast> <txt> --overwrite`
61 +- `.txt` may show duplicate lines/artifacts from terminal control sequences; acceptable if GIF looks good.
62 +- Avoid `asciinema play` in main terminal; it can disturb visible scrollback due recorded control sequences.
66 +title
= "Footer suite" 67 +extensions
= [
"footer",
"context-size",
"cost",
"git-status",
"runtime",
"quota"]
68 +targets
= [
"footer",
"context-size",
"cost",
"git-status",
"runtime",
"quota"]
71 +cwd
= "agent/extensions/lucifiber" 74 + (
"command",
"/quota",
7000),
75 + (
"prompt",
"In one short sentence, say what this directory contains.",
16000),
76 + (
"command",
"/footer",
4000),
77 + (
"command",
"/footer",
6000),
78 + (
"prompt",
"Now answer with exactly three words: footer status dashboard.",
14000),
83 +Supported step ops should stay tiny:
85 +- `type(text[, delay_ms])`
87 +- `command(text[, after_ms])` — type text slowly, pause, Enter, wait
88 +- `prompt(text[, after_ms])` — type prompt slowly, pause, Enter, wait
92 +When asked to create a driver:
93 +1. Pick visual story: what user sees, why ext matters.
94 +2. Pick exact extensions and targets.
95 +3. Add/read driver in `drivers/`.
96 +4. Run smoke once to `/tmp/<demo>.gif` first.
97 +5. Ask user to inspect GIF before committing assets/README changes.