What do you want to do?
4 use cases
-
Show an agent a bug by recording your screen and voice
Record a screen problem while narrating and clicking, then paste the bundle into any agent.
- Scrawl
- Software and DevOps
- Beginner
View 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.
-
Let an agent zoom into one moment of a recording
Give the agent the command set to pull dense frames around a timestamp, a spoken phrase, or a mark.
- Scrawl
- Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Use the scrawl command on the capture at <bundle-path>. Run `scrawl inspect --marks`, then `scrawl zoom --at <timestamp>` for the first mark, and report what happens in those frames. Verify that the reported timestamp matches the summary.md timeline.
-
Queue a capture into an OpenCode session
Send a finished bundle straight into an OpenCode session using the Scrawl send command.
- Scrawl
- Software and DevOps
- Intermediate
View prompt
Run `scrawl send <bundle-path> --session <session-id>` for the capture at <bundle-path>, then confirm the OpenCode session received the contact sheet and summary.md. Report the session ID you sent to.
How to use Scrawl
- Check you have what it needs: 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.
- Open kitlangton/scrawl on GitHub and read the README and license.
- 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
⌥⇧Sagain to finish, then press⌥⇧Vto paste the capture.
These steps come from our top use case, Show an agent a bug by recording your screen and voice, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers and product people who explain bugs or UI problems to AI coding agents and want to show them the screen instead of describing it.
- Why it is hot
- LanguageRust
- Sourcegithub.com/kitlangton/scrawl · Back to Hot repos
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
Maintain Scrawl? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/kitlangton-scrawl/?ref=badge)
Questions about Scrawl
What is Scrawl?
Scrawl is a screen recorder that packs a narrated, annotated screen capture into a bundle (contact sheet, keyframes, transcript, manifest) so an AI agent can read it. It is an open-source project on GitHub: https://github.com/kitlangton/scrawl.
Who is Scrawl for?
Developers and product people who explain bugs or UI problems to AI coding agents and want to show them the screen instead of describing it.
What can I do with Scrawl?
4 use cases so far, for example: Show an agent a bug by recording your screen and voice; Let an agent zoom into one moment of a recording; Queue a capture into an OpenCode session. Each has steps and a copy-paste agent prompt.
What do I need to run Scrawl?
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.
What are alternatives to Scrawl?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Scrawl safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.