Tool roles, alternatives, selection tradeoffs, and compatibility caveats.
Screenshot capture & annotation (CleanShot X)
John uses: CleanShot X (commercial, macOS) for section 03's whole workflow: hotkey capture → draw a fat red arrow or type the instruction on the screenshot → drag into the agent prompt. The annotation is the prompt.
| Alternative | What it is | How it differs | License |
|---|---|---|---|
| Shottr | Fast, lightweight macOS screenshot tool: annotate, scrolling capture, OCR, ruler, color picker | Pay-what-you-want (from ~$8); no screen recording or cloud; the standard CleanShot substitute for the arrow workflow | freeware/paid (closed source) |
| Flameshot | Cross-platform OSS screenshot software with in-place arrow/text annotation | Free and cross-platform (Linux/Win/mac); annotation UI is the core feature | GPL-3.0 |
| ksnip | Cross-platform screenshot and annotation tool (Qt) | OSS with rich annotation (arrows, numbering, blur); less polished than CleanShot | GPL-3.0 |
| macOS built-in Screenshot + Preview markup | Cmd+Shift+5 capture, then Markup arrows in Preview/Quick Look | Zero install; slower loop (no capture-annotate-drag single flow) | OS built-in |
| Kap | OSS macOS screen recorder (GIF/MP4) | Covers the recording half only; effectively unmaintained (check repository activity before adoption) — verify before adopting | MIT |
Pick this if…
- Shottr — you're on a Mac and want 90% of CleanShot for pay-what-you-want (no recording/cloud).
- Flameshot — you're on Linux/Windows or want it free and open; annotation UI is the core feature.
- ksnip — you want OSS with the richest annotation toolset.
- built-in Markup — you can't install anything; the loop is just slower.
- Kap — only if you need OSS recording and accept a dormant project (last push the example workflow).