Capture and annotate Mac screenshots with Claude Desktop and Codex

1. Connect the installed Mac app

Use an Apple silicon Mac running macOS 14 or later. In Snapperon Settings → Assistant Connections, choose Enable AI assistants after reading the access explanation. Copy Codex Setup or Copy Claude Desktop Setup for this installed copy, merge the copied entry into the client’s existing configuration, and reconnect its local servers. Codex uses config.toml; Claude Desktop uses the mcpServers object in claude_desktop_config.json. Existing restricted connections need Enable Full Control to adopt full app access. For help, use Troubleshooting → Save Connection Diagnostics….

2. Choose a local source

Open an image or PDF through Snapperon’s native Open File dialog, or ask for an authorized window/display capture after macOS Screen Recording approval. Source discovery refreshes for newly opened windows. In Claude Desktop, use native local-file opening or capture: raw chat-attachment byte transfer failed on the client side in testing.

3. Ask for a concrete markup pass

For example: “Use the open settings image. Add counters 1–3 beside the three switches, a curved arrow at Save Changes, and a short label explaining the final step. Keep the UI text visible.” The assistant should inspect the source and discover valid tool settings before choosing positions.

4. Review the staged render

The assistant prepares the edit without applying it, inspects the rendered preview, and revises the same batch if labels overlap controls. New labels preserve wrapping width and expand vertically to fit content. Inspect the staged render before commit_edit. Check both placement and wording; a model’s interpretation still needs review.

5. Commit once and polish by hand

Commit the approved batch as one native Undo action. Move, resize, restyle or remove individual layers in Snapperon. If the batch is wrong, undo it once rather than rebuilding the image from scratch.

6. Copy or export the documentation visual

Choose Copy + Close, copy to an authorized clipboard, or export PNG/JPEG. Use Choose Export Folder… to approve the save destination. Inspect a redacted flattened output before sharing. PNG/JPEG output is flattened; the editable layers stay in the native editor.

Questions answered