{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "kitlangton-scrawl--show-agent-a-bug-by-recording-it",
 "repo": "kitlangton/scrawl",
 "repo_url": "https://github.com/kitlangton/scrawl",
 "repo_slug": "kitlangton-scrawl",
 "title": "Show an agent a bug by recording your screen and voice",
 "page_title": "How to show an agent a bug by recording your screen and voice with Scrawl",
 "summary": "Record a screen problem while narrating and clicking, then paste the bundle into any agent.",
 "who": "A developer or designer hitting a UI bug who would rather show the problem than write a long description for an AI agent.",
 "problem": "Describing a visual or interaction bug in text takes time and loses detail, so the agent often guesses wrong.",
 "outcome": "The agent receives a contact sheet of annotated keyframes and a time-aligned transcript and timeline, and can point to the exact moment that is broken.",
 "steps": [
  "Download the DMG from Scrawl.kitlangton.com, or run `brew install --cask kitlangton/tap/scrawl`.",
  "Finish the welcome tour and grant Screen & System Audio Recording, Microphone, and Accessibility.",
  "Press `⌥⇧S`, talk through the problem, click around, and draw on the screen with Shift held for ink.",
  "Press `⌥⇧S` again to finish, then press `⌥⇧V` to paste the capture.",
  "Paste the contact sheet and summary into your agent and ask it to explain the bug."
 ],
 "agent_prompt": "Using the Scrawl bundle at <bundle-path>, read contact-sheet.png and summary.md, open the keyframes the narration points to, and list each bug you can see with its timestamp. Verify that every timestamp you cite appears in the summary.md timeline.",
 "agents": [
  "any"
 ],
 "difficulty": "Beginner",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "Scrawl is built for Apple silicon Macs on macOS 26 or later, and the Windows build is an unsigned preview that does not update itself yet.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "rust",
 "requirements": [
  "An Apple silicon Mac running macOS 26 or later (or Windows 10 2004 or later, x64, preview build)",
  "Screen & System Audio Recording, Microphone, and Accessibility permissions granted during onboarding",
  "Claude Code, Codex, or another agent that can read the pasted contact sheet and summary.md",
  "For the source-build steps: a Rust toolchain with cargo"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The recording captures everything on screen and in your narration, so passwords, tokens, or private messages visible during the capture end up in the bundle."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/kitlangton-scrawl/show-agent-a-bug-by-recording-it/",
 "md": "https://dedupedai.com/use-cases/kitlangton-scrawl/show-agent-a-bug-by-recording-it/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/kitlangton-scrawl--show-agent-a-bug-by-recording-it.json",
 "api_version": "v1"
}