kitlangton/scrawl

Scrawl 的核心主张很简单：Agent 卡住时，直接让它“看”问题，比用文字描述更省事。如果你平时用编程 Agent，又经常反复解释界面上的异常，这个工具值得在 Mac 上试一次。

解决什么问题

你在开发页面或应用时碰到一个 bug，需要让编程 Agent 理解它。靠打字说“点这里，然后这里不对，那个间距很怪”既慢又容易丢信息，截图又丢掉操作顺序和你的口述。Scrawl 改的是采集这一步：按一次快捷键开始录屏，一边说一边点击、在画面上标注，再按一次结束。得到的不是一段原始视频，而是一个包含标注关键帧、转写文本和结构化时间线的材料包，装好技能后 Agent 可以直接读取。Agent 拿到的是现场证据，而不是你事后的复述。

有什么不同

Scrawl 不把视频文件直接丢进对话，而是把录制整理成面向 Agent 的产物：带标注关键帧的 contact sheet、全分辨率单帧、按时间对齐的转写与交互时间线 summary.md，以及 scrawl.json 清单。因为转写和屏幕操作在时间上对齐，Agent 可以把“按钮会跳”和“你点下去的那一刻”对应起来。CLI 暴露的是同一批材料：inspect 输出摘要或 JSON，frames --from/--to 按时间段取帧，让 Agent 聚焦某一瞬间。

Scrawl 还试图缩短投递环节。如果一次录制结束时，前台浏览器正显示某个项目的开发站点，它可以直接发到该项目的 OpenCode 会话；route --url 可以只查看会发往哪里而不实际发送。自动裁剪是另一个关键机制：录制整个屏幕，由 Scrawl 推断你主要在哪个区域操作，再裁剪每张关键帧，而不是让你事先框选。README 说裁剪参数是在模拟录制和人工标注的理想裁剪上调出来的——这是作者对调参过程的说明，不是独立准确率测试。自动裁剪是启发式方法，代价是手势不明确或窗口重叠时，裁剪结果可能不符合预期；审阅窗口和 autocrop 调试面板就是用来检查和调整的。

谁值得试

适合已经在用 Claude Code、OpenCode、Codex 等 Agent，且问题偏视觉或交互的开发者：布局错乱、悬停状态异常、要点好几下才复现的流程。反过来，如果你主要做终端或后端问题，一段文字报错本来就更清楚，就不太需要它；如果你的机器不在支持范围内，也不合适——主力版本面向 Apple silicon Mac 和 macOS 15 及以上，部分功能需要 macOS 26。Windows 有预览版，但未签名、暂不支持自更新，投入程度完全不同。

使用条件与边界

Mac 用户需要 Apple silicon 机器和 macOS 15 或更新版本；实时转写和 Liquid Glass 需要 macOS 26。首次启动有四个引导页，其中包括 Scrawl 需要的全部权限，屏幕录制等授权不齐就不会继续，这是正常但真实的准备成本。Windows 明确是预览版、未签名，会遇到 SmartScreen 提示，更新也要手动。

Agent 工作流本身也有维护成本。要让 Agent 读取材料包，需要安装技能，并把 scrawl 命令链接到 PATH——Homebrew cask 会做这件事，或者用设置里的 Agents 页面安装。开发站点自动投递目前面向 OpenCode 会话和一组特定浏览器。如果投递失败，README 特别提醒：决定收件人的是原始顶层目标字段，而不是 context.session，并且重发前应先确认录制是否已经送达。

HotRepo 点评

HotRepo 从 2026-10-24 开始跟踪这个仓库，唯一存储的榜单记录是 2026-10-25 在 Rust 新项目榜（新项目榜，并非总榜/日榜）排 #11、总星数 728。这只是一个 10 天新项目的单日快照，不是每日增长曲线，无法据此判断热度能否持续。在长期依赖它之前，先拿一次真实录制，看看 contact sheet 和 summary.md，确认自动裁剪在你的布局下是否好用、你的 Agent 是否真的按预期读取材料包。