AB
AB
AiBoss

All Categories

project

scrawl - 用录屏代替描述，把问题直接交给 AI 代理

scrawl 是一款面向 AI 编码代理的屏幕录制工具：按下快捷键录下屏幕、语音与标注，打包成带关键帧、转录文本和结构化清单的素材包，让代理直接「看」到问题而不是听你描述。

scrawl 是一个把「描述问题」换成「展示问题」的屏幕录制工具。据项目自述，用户按下快捷键 ⌥⇧S 后 scrawl 开始录屏，可以一边说话、一边点击操作、一边在画面上涂画，再按一次 ⌥⇧S 结束。录制完成后，scrawl 会把屏幕画面、语音和标注打包成一个紧凑的素材包，交给 AI 编码代理去读。它适合那些需要向 Claude Code、OpenCode、Codex 等代理说明界面问题、交互缺陷或操作流程的开发者——与其用文字费力描述「点这里之后那里不对」，不如直接录一段。

维护者与状态

项目由 kitlangton 维护，仓库创建于 2026-10-14，最后提交时间为 2026-10-25。最新正式版本为 v0.3.13，发布于 2026-10-22。截至 2026-10-29，仓库获得 795 个星标。项目同时提供官网用于下载与文档查阅。

主要能力

以下能力均据项目 README 自述整理：

  • 一次录制，多种素材：录制结果被打包为若干文件，包括带标注关键帧的拼版图 contact-sheet.png、逐张全分辨率关键帧 frames/frame-XX.png、时间对齐的转录与交互时间线 summary.md，以及结构化清单 scrawl.json。
  • 面向代理的技能包：项目提供可安装的 agent skill，支持 Claude Code、OpenCode、Codex 等代理。安装后，代理拿到 scrawl 粘贴的内容，会先读拼版图和转录，再打开旁白指向的关键帧，并可用命令行进一步细看。
  • 按时间点细看：据 README，scrawl zoom --at 0:12 可以围绕某一时刻生成密集帧图，--at 也接受用户说过的某句话，--mark 2 则对应文本中显示为 ✎② 的标注；scrawl inspect --marks 可列出全部标注。
  • 帧提取与导出：scrawl frames 可拉取指定时间区间的帧，scrawl send 可把一次捕获排入 OpenCode 会话，scrawl export 可导出便于分享的 .mp4 文件。
  • 其他命令行能力：README 还列出了 preview（在原生窗口中回看素材包）、inspect（打印摘要或 JSON 清单）、route（判断某次捕获会发往哪个会话而不实际发送）、record --iphone（从终端录制有线连接的 iPhone）、import（从应用内录制构建素材包）、reprocess（用当前转录器与关键帧规则重建素材包）、recover（修复构建中断的捕获）、autocrop（实时调整自动裁剪）、clean 与 pin（清理旧捕获或永久保留某一次）等子命令。
  • 首次启动引导：首次启动会打开欢迎窗口，包含欢迎页、快捷键说明、权限申请页和第一次捕获。权限页把屏幕录制、麦克风、辅助功能逐项列出，每项配一个按钮触发系统提示，授权后自动打勾；三项全部开启后才能继续。

使用入口

项目仓库地址为 kitlangton/scrawl，官网为 scrawl.kitlangton.com，可从官网下载安装包。

据 README，macOS 用户可通过 Homebrew 安装：

brew install --cask kitlangton/tap/scrawl

应用自带更新机制（Sparkle），因此 Homebrew 不负责更新。Windows 10（2004）及以上 x64 用户可从同一页面或 GitHub 最新 release 下载 zip，解压后运行 scrawl.exe。

为代理安装技能包：

bunx skills add kitlangton/scrawl

scrawl 命令即 Scrawl.app 内的二进制文件。Homebrew cask 会把它链接到 PATH；也可以在设置中点击命令行工具旁的「Install」，将其链接到 /opt/homebrew/bin 或 /usr/local/bin（无写入权限时则链接到 ~/.local/bin）。该链接始终指向应用当前副本，随应用一起更新。scrawl skill 可在不安装的情况下打印技能内容。

从源码运行的方式包括：

cargo run -- app
cargo run -- demo --out /tmp/demo.scrawl
cargo run -- preview /tmp/demo.scrawl
cargo run -- inspect /tmp/demo.scrawl --json

许可与限制

项目采用 MIT 许可证。

据 README 说明，使用前需注意以下边界：

  • 平台要求：macOS 端需要 Apple silicon 芯片且系统为 macOS 15 或更高；实时转录与 Liquid Glass 效果需要 macOS 26。
  • Windows 版本为预览：Windows 构建尚未签名，系统可能提示「Windows protected your PC」，需点击「More info」再「Run anyway」；该版本目前也不会自动更新。
  • 权限依赖：屏幕与系统音频录制、麦克风、辅助功能三项为必需权限，未开启时 ⌥⇧S 不会启动录制。摄像头权限仅在首次选择 iPhone 镜像时申请。项目明确表示不会申请输入监控权限。
  • 屏幕录制授权的特殊性：屏幕录制授权可能不会立即作用于正在运行的应用，macOS 会提供「Quit & Reopen」或「Later」选项；选择后者时 scrawl 会自行检测能否捕获，必要时自动重启一次（两分钟内仅一次）。
  • 引导流程：引导进度记录在 ~/.config/scrawl/config.json 中，设置环境变量 SCRAWL_NO_ONBOARDING=1 可跳过引导。

以上能力与限制均来自项目自述，实际表现请以仓库与官方文档为准。

Back