demo-play
Drive LibrAgent desktop chrome for product/hero demos via App Control MCP (POST /mcp/control) and optional session HTTP APIs. Use when filming README hero clips, pacing Extensions install → chat → del
SKILL.mdsrc-tauri/bundled_skills/demo-play/SKILL.md
GitHubDemo Play
Compose generic App Control primitives into timed demo beats. There is no
demo__run_hero server tool — sequences live in this skill / scripts.
Preconditions
- Prefer demo profile (isolated DB + env-seeded LLM):
scripts/run-demo.shorlibragent --demo --mcp --app-control- Loads
.env.demo(LIBRAGENT_LLM_*OpenAI-compat endpoint)
- Or open any build with both:
--mcp/LIBRAGENT_MCP_ENABLE=1--app-control/LIBRAGENT_APP_CONTROL=1
- HTTP port:
~/.libragent/http_port(fallback3030). - Control endpoint:
http://127.0.0.1:<port>/mcp/control
If tools/list on /mcp/control fails, stop and ask the operator to restart
with the flags above. Details: references/app-control.md.
Core workflow
1. Pick the beat
| Intent | Action |
|---|---|
| Primary hero (Extensions → install → chat) | Run scripts/play_hero_chrome.sh or call primitives below |
| Custom path / highlight only | Call primitives via scripts/app_control.sh |
| Full product story + prompts | Read references/hero-shot-list.md |
2. Drive chrome (primitives)
Prefer the helper script (resolves port, posts JSON-RPC):
bash "<skill-base-dir>/scripts/app_control.sh" app__highlight '{"target":"preset","name":"hn","ms":2500}'
bash "<skill-base-dir>/scripts/app_control.sh" app__wait_ui '{"ms":800}'
bash "<skill-base-dir>/scripts/app_control.sh" app__install_preset '{"name":"hn"}'
Quiet zero-config presets only (no extra browser/dashboard):
hn, arxiv, ddg-search, docx, yahoo-finance.
Do not use for hero chrome: serena (opens a local web dashboard in the
browser and steals focus), key/OAuth presets (github, exa, …), or anything
that launches a separate GUI.
3. Session + deliverable (optional)
After chrome beats:
POST /api/sessionswithassistantId(+ optionalworkspacePath,request)app__focus_sessionwith returnedid- Deliverable prompt from references/hero-shot-list.md
Pacing: linger ~2s on Install success; use app__wait_ui between steps (500–1500ms).
4. Capture
Operator records the window. For stills/pixel capture, hand off to
@skill:app-screenshot — this skill does not capture video.
Rules
- Compose sequences in the client/scripts — do not invent composite MCP tools.
- Prefer one chrome path: Extensions → agent chat. Avoid Settings tours.
- Keep positioning: Install tools like apps. Keep your model. Keep the file.
- Idempotent install is OK (already installed → no-op); for filming Install,
uninstall a quiet preset first (or use a clean demo profile). Never switch
to
serenajust because it was free — its dashboard browser ruins the take.