usecases.sh
usecases.sh
Software & DevOps

Record a captioned looping demo GIF for a project README

Hiroki Kondo had Claude Code script, record, caption and assemble a 20 to 30 second looping README GIF for karasu, his architecture diagram tool, all inside a devcontainer.

Done with

What they did

Hiroki Kondo develops karasu, an architecture diagram tool, and wanted a looping demo at the top of its README. He runs Claude Code inside a VS Code devcontainer. Claude Code drafted the script, started the karasu preview server in the container, drove a browser with Playwright and captured frames through the Chrome DevTools Protocol screencast, which only emits a frame when the screen changes. The cursor and captions were overlays drawn on the page, and ImageMagick stitched the frames into a GIF. For the demo subject it reverse-engineered his private AI journaling service into a karasu model, running 13 subagents, one per domain, on about 1.5 million tokens. The recording scripts were committed to the repo so the GIF can be re-shot when the UI changes.

How it went

His first ask, a 3-minute intro video, got exactly that. Once he said the goal was a README loop, Claude Code proposed 20 to 30 seconds and dropped the command-line scenes. The first 18-second prototype had no captions and did not explain itself; about 14 minutes after asking, he had captioned and uncaptioned versions side by side and kept the captioned one. Claude Code also scrubbed the private repo name from captions, breadcrumbs and service names and flagged a leftover comment before commit. The opening terminal scene is a rebuilt replay of a real 15-minute run.

Worth knowing

He kept the work inside the container on purpose rather than letting the agent use computer use in his own logged-in browser, and asked it to list everything it installed and how to undo it. A Japanese font had to be added or the Japanese captions rendered as boxes. Lead with where the video will live, not its length or format.

Try it withClaude Code

Make a short looping demo GIF of [my app] for the top of [my README]. Work only inside [this devcontainer or sandbox], not in my own browser. First propose a script of [20 to 30] seconds showing [the main thing the app does], with captions, and wait for my approval. Then start the app, drive it with Playwright, record frames only when the screen changes, draw the cursor and captions as page overlays, and assemble the GIF with ImageMagick. Check that no [private names or repo names] appear anywhere in the frames. Save the recording scripts in [scripts/demo] so I can re-record later, and finish by listing everything you installed and how to remove it.

Square brackets are the parts to fill in. The prompt is ours; the story is theirs.

Where they said it

All Software & DevOps use cases

Every entry is something a person reported doing with an agent, rewritten in our words, with a link to where they said it. Found across the web every hour; reviewed before it ships.

Maintained by an agent that uses One for every integration it touches.