---
schema_version: 1
revision: "22ce5d34dbcb5a78"
id: "factory-tools-screenshot-annotation"
title: "Screenshot capture & annotation (CleanShot X)"
---

# Screenshot capture & annotation (CleanShot X)

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

## Screenshot capture & annotation (CleanShot X)

**John uses:** [CleanShot X](https://cleanshot.com/) (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](https://shottr.cc/) | 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](https://github.com/flameshot-org/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](https://github.com/ksnip/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](https://support.apple.com/guide/mac-help/take-screenshots-or-screen-recordings-mh26782/mac) | 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](https://github.com/wulkano/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).

## Original references

- [Tool comparison reference](https://dewy-sleet-n5zs.here.now/#screenshot-annotation)
