Screenshot capture & annotation (CleanShot X)

Tool roles, alternatives, selection tradeoffs, and compatibility caveats.

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).

Source references