| name | update-readme-screenshot |
| description | Refresh the popover screenshot embedded in README.md by running a real Claude Code session against a disposable demo project, rendering monica's popover with that session selected, and uploading the result via `gh image` (no PNG committed to the repo). Use when the popover UI has changed visually and the README screenshot is stale. |
| user_invocable | true |
update-readme-screenshot
Regenerates the README's popover screenshot end to end, without touching any of your
real tmux sessions or their transcripts, and without adding a binary to the repo:
- Creates a throwaway project at
/tmp/demo-app (a two-line main.go + README.md).
- Starts a new tmux session (
monica-demo) and launches a real claude there —
real integration, not fabricated transcript/aistatus files (their exact shapes are
finicky enough that faking them isn't worth it — see AGENTS.md's transcript-format
gotchas).
- Drives one short, clean prompt designed to produce a nicely structured reply (a
heading + a few bullet points) — good screenshot content, no real work content.
- Waits for that session to go idle (polls its
aistatus pid file).
- Builds monica's debug binary and renders the popover via the
MONICA_SHOT hook
(see the sibling screenshot-test skill and AGENTS.md's "Verifying the GUI"
section) — no Screen Recording permission needed.
- Filters the popover to the demo agent by typing
demo-app into the search field
(robust regardless of how many real agents are running — no row-counting).
