Repolode
Submit
kitlangton

kitlangton/scrawl

A macOS app that records your screen, voice and on-screen markup into a compact bundle of annotated frames and a transcript for coding agents.

Open-source alternative to:Loom

View on GitHubWebsite
Stars
884
Forks
89
Open issues
36
Last commit
6 days ago

What is it?

Scrawl lets you show a coding agent a problem instead of describing it. Press a shortcut to start recording the screen, talk, click around and draw on it, then press the shortcut again to stop. It packs the capture into a bundle containing a contact sheet of annotated keyframes, full-resolution frames, a time-aligned transcript with an interaction timeline, and a structured JSON manifest.

The app is built with Rust and GPUI and targets Apple silicon Macs on macOS 15 or later, with a preview Windows build also available. It includes a skill for Claude Code, OpenCode, Codex and similar agents, plus a CLI for zooming into moments, extracting frame ranges, sending captures to an OpenCode session, and exporting shareable MP4 videos with ink and auto-zoom.

It also ships ScrawlKit, a Swift package that lets an iOS app record its own screen, touches and narration and send the result to a Mac or HTTPS endpoint.

Key features

  • 01Records screen, narration and on-screen ink, pins and clicks in one capture.
  • 02Produces a contact sheet of annotated keyframes plus full-resolution frames.
  • 03Generates a time-aligned transcript and interaction timeline in summary.md.
  • 04Lets agents zoom into a moment or extract a frame range from a bundle via CLI.
  • 05Sends captures to an OpenCode session or the clipboard.
  • 06Exports shareable MP4 videos with burned-in annotations and optional auto-zoom.

Use cases

  • Showing a coding agent a UI bug or layout issue by recording and pointing at it.
  • Documenting a visual problem with narration for a teammate or an AI assistant.
  • Capturing a cabled iPhone or an iOS app's behavior for review with an agent.
  • Turning a screen recording into a shareable annotated walkthrough video.

Quick start

  1. 1

    Install the Homebrew cask (Apple silicon Mac, macOS 15+)

    brew install --cask kitlangton/tap/scrawl
  2. 2

    Press ⌥⇧S to start recording, and press it again to finish

  3. 3

    Install the agent skill for Claude Code, OpenCode, Codex and other agents

    bunx skills add kitlangton/scrawl

Things to know

  • Requires an Apple silicon Mac on macOS 15 or later; live transcription and Liquid Glass need macOS 26.
  • The Windows build is a preview and is not signed yet, and it does not update itself.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI coding assistants & agentsOpen-source Mac apps

Topics

#ai-agents#screen-recording#developer-tools#macos#coding-agents#rust#video-export#claude-code#gpui#opencode

FAQ

What is scrawl?
A macOS app that records your screen, voice and on-screen markup into a compact bundle of annotated frames and a transcript for coding agents. Scrawl lets you show a coding agent a problem instead of describing it. Press a shortcut to start recording the screen, talk, click around and draw on it, then press the shortcut again to stop. It packs the capture into a bundle containing a contact sheet of annotated keyframes, full-resolution frames, a time-aligned transcript with an interaction timeline, and a structured JSON manifest.
Is scrawl free to use? What license does it have?
scrawl is open source under the MIT license. Check the license terms before using it in commercial products.
Is scrawl still maintained?
Actively maintained. The last commit to scrawl was on Nov 1, 2026.
What can I use scrawl for?
Showing a coding agent a UI bug or layout issue by recording and pointing at it. Documenting a visual problem with narration for a teammate or an AI assistant. Capturing a cabled iPhone or an iOS app's behavior for review with an agent. Turning a screen recording into a shareable annotated walkthrough video.
How do I install scrawl?
Install the Homebrew cask (Apple silicon Mac, macOS 15+): brew install --cask kitlangton/tap/scrawl Press ⌥⇧S to start recording, and press it again to finish Install the agent skill for Claude Code, OpenCode, Codex and other agents: bunx skills add kitlangton/scrawl
Where can I get scrawl?
The source code and installation instructions are on GitHub: https://github.com/kitlangton/scrawl

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects