kitlangton/scrawl

选用指南

AI 根据 README 整理 · 2026/10/20 00:31:50

适用场景

适用于向 AI 代理展示问题，支持将捕获内容发送到 OpenCode 会话。

查看 README 依据

# Scrawl Show an agent a problem instead of describing it. Press a shortcut (`⌥⇧S`) and Scrawl starts recording the screen. Talk, click around, draw on it, and press `⌥⇧S` again to finish. Scrawl records the screen, your voice, and your marks, then packs them into a compact bundle: a contact sheet of annotated keyframes (`contact-sheet.png`), individual full-resolution keyframes (`frames/frame-XX.png`), a time-aligned transcript and interaction timeline (`summary.md`), and a structured manifest (`scrawl.json`). ## Install

clicking the selected mode again starts recording (`⏎`/`⌥⇧S` record the full screen from Area and Window too) ## Sending captures of a dev site to its session A capture that ends with a browser in front showing a project's dev site goes straight to that project's OpenCode session, the same way iPhone recordings do. It is still copied to the clipboard. The island says "Sending to SCRAWL…", then "Sent to SCRAWL", or "Copied · couldn't reach SCRAWL" when OpenCode didn't take it (the app retries it, as for iPhone recordings). Window captures use the

使用方式

通过快捷键 ⌥⇧S 启动录制，也可用命令行工具进行录制、预览、导出等操作。

查看 README 依据

# Scrawl Show an agent a problem instead of describing it. Press a shortcut (`⌥⇧S`) and Scrawl starts recording the screen. Talk, click around, draw on it, and press `⌥⇧S` again to finish. Scrawl records the screen, your voice, and your marks, then packs them into a compact bundle: a contact sheet of annotated keyframes (`contact-sheet.png`), individual full-resolution keyframes (`frames/frame-XX.png`), a time-aligned transcript and interaction timeline (`summary.md`), and a structured manifest (`scrawl.json`). ## Install

Scrawl needs an Apple silicon Mac on macOS 26 or later. Download the DMG from [scrawl.kitlangton.com](https://scrawl.kitlangton.com), or use Homebrew: ```sh brew install --cask kitlangton/tap/scrawl ``` The app updates itself (Sparkle), so Homebrew leaves updates to it. ## Usage ```sh # Launch the GPUI menu-bar and review app (tap ⌥⇧S to record, hold it to choose what to record) cargo run -- app # Generate a realistic multi-frame demo bundle and print its agent summary cargo run -- demo --out /tmp/demo.scrawl # Open a bundle (or `latest`) in the native GPUI review window

部署要求

需要 Apple silicon Mac 且 macOS 26 或更高版本。

查看 README 依据

Scrawl needs an Apple silicon Mac on macOS 26 or later. Download the DMG from [scrawl.kitlangton.com](https://scrawl.kitlangton.com), or use Homebrew: ```sh brew install --cask kitlangton/tap/scrawl ``` The app updates itself (Sparkle), so Homebrew leaves updates to it. ## Usage ```sh # Launch the GPUI menu-bar and review app (tap ⌥⇧S to record, hold it to choose what to record) cargo run -- app # Generate a realistic multi-frame demo bundle and print its agent summary cargo run -- demo --out /tmp/demo.scrawl # Open a bundle (or `latest`) in the native GPUI review window