Show your coding agent what happened
Describing a UI bug in a prompt is slow and lossy. Record it instead. A recording carries what you clicked, what broke, and what the error said, and the transcript carries your narration, word for word.
- Record the repro once, narrating as you go
- Copy the transcript with timestamps in one click
- Drop the clip into Claude Code, Cursor, or any agent chat
The problem with typing out a repro
An agent fixing a UI bug needs the same things a teammate would. It needs the exact steps, the exact error text, and the context you'd say out loud. Typing that into a prompt loses information at every step. You paraphrase the error, forget a step, and skip the aside ("it only happens when the cart has a subscription item") that identifies the bug.
The workflow
- Start a recording of the window where the bug happens.
- Reproduce it once, narrating as you go. Say what you're doing and what you expected. Don't worry about stumbles. You can cut them from the transcript afterward.
- Stop. The transcript is already done, because it was generated on your Mac while you recorded.
- Copy the transcript with timestamps in one click, and export the clip as an MP4.
- Paste both into the agent chat. The transcript gives the agent your narration as text it can reason over, keyed to timestamps in the video, as in this example.
> fix the checkout crash, recording attached
00:04 I add the discount code and press Pay.
00:09 The button spins forever, and the console shows a 500
from /api/checkout.
00:17 It only happens when the cart has a subscription item.
Why this fits agent workflows
- The transcript is text. Agents consume it directly, with no waiting on audio extraction, and your steps arrive word for word.
- Timestamps anchor the video. An agent (or a teammate) can jump to 00:09 and read the console frame themselves.
- No upload service in the loop. The MP4 is a local file the moment you stop recording. Nothing about your codebase or your screen transits a third-party video host.
- Works offline. Recording and transcription run on your Mac, so this works the same on a plane or an air-gapped network.
The same clip works for people
The same clip drops into a pull request, a bug tracker, or Slack. For issues a person will triage first, see bug reports and QA.
Video
This page's video shows the workflow end to end. The steps it records are written up in the coding-agents video script.