Mô tả một bug cho agent bằng chữ thường mất nhiều thời gian hơn chỉ cho nó xem. Scrawl làm đúng việc đó: bấm ⌥⇧S để bắt đầu ghi màn hình, vừa nói vừa click vừa vẽ lên chỗ sai, bấm ⌥⇧S lần nữa để dừng. Toàn bộ được đóng gói thành một bundle nhỏ gọn để agent đọc.
Repo là kitlangton/scrawl, viết bằng Rust, license MIT, hiện có 483 sao. Tác giả là Kit Langton, người đứng sau Zed. Điểm khiến tôi để mắt: nó không bắt agent xem video. Nó chuyển video thành thứ agent đọc được bằng text và ảnh.
Nó làm gì, cụ thể
Bundle đầu ra gồm bốn thứ. Một contact-sheet.png là bảng các keyframe đã đánh dấu, để agent nhìn phát là nắm được diễn biến. Các keyframe gốc độ phân giải đầy đủ nằm trong frames/frame-XX.png. Một summary.md chứa transcript căn theo thời gian và timeline tương tác (click, kéo, cuộn). Cuối cùng là scrawl.json, manifest có cấu trúc để máy parse.
Vấn đề nó giải quyết rất thật. Agent như Claude Code hay Codex không xem được video, còn bạn thì ngại gõ mười dòng mô tả một lỗi UI lệch 4px. Ghi màn hình thì nhanh, nhưng file mp4 thì agent không mở được. Scrawl đứng giữa hai đầu đó.
Có một chi tiết tôi thích: lệnh scrawl zoom --at 0:12 hoặc --at "câu bạn đã nói" cho agent trích thêm frame dày đặc quanh một mốc thời gian. Nghĩa là agent không bị giới hạn ở những frame có sẵn, nó chủ động “soi” kỹ hơn khi cần. Đây là thiết kế đúng hướng cho tool dành cho agent.
Vì sao đang được chú ý
Repo tạo ngày 2026-10-14, cập nhật 2026-10-20, tức là mới vài ngày mà đã 483 sao. Con số đó với một tool macOS-only, lại yêu cầu macOS 26, là khá cao. Lý do nằm ở chỗ nó nhắm đúng vào workflow đang nóng: đưa ngữ cảnh trực quan cho coding agent.
Một điểm khác biệt so với mấy tool quay màn hình thông thường: Scrawl được thiết kế cho agent từ đầu, không phải quay xong rồi tính. Có sẵn skill để cài cho Claude Code, OpenCode, Codex bằng một lệnh, có lệnh send đẩy thẳng capture vào phiên OpenCode, có lệnh route đoán xem capture của một dev site sẽ đi vào session nào. Đây là mức tích hợp mà tool quay màn hình đại trà không có.
Nó cũng chạy native trên GPUI (cùng framework UI của Zed), nên app menu-bar và cửa sổ review đều nhẹ. Không phải Electron.
Cài và dùng thử
Yêu cầu: Mac chip Apple silicon, macOS 26 trở lên. Cài qua Homebrew:
brew install --cask kitlangton/tap/scrawlHoặc tải DMG từ scrawl.kitlangton.com. App tự update bằng Sparkle nên Homebrew để yên cho nó tự lo.
Cài skill cho agent:
bunx skills add kitlangton/scrawlLệnh scrawl thực chất là binary nằm trong Scrawl.app. Cask của Homebrew link nó vào PATH, hoặc vào Settings › Agents bấm Install để link vào /opt/homebrew/bin, /usr/local/bin, hoặc ~/.local/bin.
Muốn nghịch thử mà không cần quay thật, có lệnh tạo bundle demo:
cargo run -- demo --out /tmp/demo.scrawlRồi xem nó bằng cửa sổ review native, hoặc in phần summary cho agent:
cargo run -- preview /tmp/demo.scrawl
cargo run -- inspect /tmp/demo.scrawlTrích frame trong một khoảng thời gian:
cargo run -- frames /tmp/demo.scrawl --from 0:02 --to 0:07Và xuất video chia sẻ được, có tùy chọn auto-zoom:
cargo run -- export latest --zoom --out /tmp/demo.mp4Windows 10 (2004) trở lên cũng có build x64 dạng preview, tải zip từ trang chủ hoặc GitHub release, giải nén chạy scrawl.exe. Bản này chưa ký nên Windows sẽ cảnh báo “Windows protected your PC”, bấm More info rồi Run anyway. Chưa tự update.
Ai nên dùng
Dev đang làm việc hằng ngày với Claude Code, OpenCode hay Codex và hay gặp lỗi UI, lỗi layout, lỗi hành vi khó tả bằng chữ. Bạn quay 10 giây, nói “chỗ này nó nhảy sang phải khi resize”, khoanh đỏ vào cái nút, agent đọc bundle và biết chính xác phải sửa file nào.
Cũng hợp với người review code hoặc QA nội bộ: thay vì gõ ticket mô tả, quay một phát là xong. Có lệnh record --iphone --duration 8 để quay iPhone cắm dây, tiện cho việc test app mobile rồi đưa cho agent.
Không hợp nếu bạn dùng Linux, hoặc Windows mà cần bản ổn định có ký. Cũng không hợp nếu team bạn không dùng agent nào cả, vì lúc đó Scrawl chỉ là một tool quay màn hình khá đắt công cài đặt.
So với lựa chọn khác
Tôi chưa thử đủ các tool cùng loại để so sánh công bằng, nên chỉ nói phần chắc chắn: hầu hết tool quay màn hình (QuickTime, Loom, CleanShot) cho ra video cho người xem. Scrawl cho ra bundle cho agent đọc, kèm lệnh để agent chủ động trích thêm dữ liệu. Đó là khác biệt về bản chất, không phải về tính năng.
Ưu, nhược, lưu ý
Ưu: thiết kế đúng cho agent, output có cấu trúc rõ ràng (ảnh, markdown, JSON đều tách bạch), tích hợp sẵn skill cho ba agent phổ biến, chạy native GPUI nên nhẹ, license MIT thoải mái dùng và sửa.
Nhược và lưu ý thì không ít. Ràng buộc nền tảng khá gắt: Apple silicon, macOS 26 trở lên. Nếu máy bạn còn macOS 15 thì chịu. Bản Windows mới là preview, chưa ký, chưa tự update. Dự án mới vài ngày tuổi, API với CLI còn có thể đổi, đừng đem vào pipeline production ngay. Tài liệu khá dài nhưng viết theo kiểu ghi chú nội bộ, nhiều chỗ phải đọc kỹ mới hiểu, nhất là phần permissions (Screen Recording, Microphone, Accessibility). Cài lần đầu sẽ phải cấp ba quyền, hơi lằng nhằng.
Một điểm trừ nhỏ về trải nghiệm: README dùng cargo run -- cho hầu hết ví dụ, trong khi người dùng thường chỉ có binary scrawl từ cask. Đọc hơi rối nếu bạn không phải dev Rust.
Scrawl đáng để cài thử nếu bạn đang dùng coding agent mỗi ngày và thấy việc mô tả lỗi bằng chữ là điểm nghẽn. 483 sao trong 6 ngày là tín hiệu tốt, nhưng cứ chạy demo trước, xem bundle nó sinh ra có đúng kiểu dữ liệu agent của bạn cần không, rồi hẵng quyết. Repo ở đây: kitlangton/scrawl.
