Skip to content

About

Screenshots for AI agents and you: a Mac screenshot app + CLI. Up to 75% fewer image tokens with no detail lost, about 2x faster than screencapture.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Snip icon

Snip

Screenshots for agents. And for you.
Up to 75% fewer image tokens with no detail lost, and about 2x faster than macOS screencapture.
Press ⌘ ⇧ A to snap, mark up, scroll, record, and pin.
Your coding agent runs snip to do the same from the terminal.

macOS 14+ Swift No network Sandboxed Download MIT License

Snip in 27 seconds: select and mark up, scroll a long chat, record a region, then an agent runs snip shot, ocr, mark, and pin
Watch in full quality (MP4)

For you and your agent

Left: a person marks up a dashboard with ⌘⇧A. Right: an agent runs snip shot, ocr, mark, and pin, and the marked screenshot floats on screen.

You press ⌘ ⇧ A Your agent runs snip
Click a window or drag a region.
Box it, arrow it, number the steps, blur the secrets.
Scroll for one long image, or record an MP4.
Enter copies it. Or pin it above everything.
snip shot --app Safari to see what you see.
snip scroll --app Slack for the whole thread.
snip ocr finds the words, with pixel boxes.
snip mark and snip pin to point you at the problem.

Same app, same stitching, same markup style. Set up the CLI in one command.

Install

Download: grab Snip-1.0.1.dmg from the latest release. It's a universal build (Apple silicon and Intel, macOS 14+), signed with Developer ID and notarized by Apple. Open it and drag Snip to Applications.

Mac App Store: Snip: Screenshots for Agents.

Agent CLI (snip, for Claude Code, Codex, Cursor or any shell): git clone https://github.com/anup-a/screenshot-for-agents && ./screenshot-for-agents/install-cli.sh. More in For agents.

Build from source (requires macOS 14+ and Xcode or the Swift toolchain):

git clone https://github.com/anup-a/screenshot-for-agents.git
cd screenshot-for-agents
./build.sh            # builds build/Snip.app
./build.sh --install  # copies it to /Applications and launches it

build.sh signs with your Apple Development identity, so the Screen Recording permission survives rebuilds.

First launch

Snip needs Screen Recording permission, like every screenshot app on macOS. On first launch a setup window links straight to System Settings → Privacy & Security → Screen & System Audio Recording, shows live when access is granted, and offers a one-click relaunch (macOS only applies the permission after a relaunch). You can reopen it any time from the menu bar with Screen Recording Permission….

The menu bar item also has Take Screenshot and Launch at Login.

Tokens

Tokens per screenshot on a 15-inch MacBook Air. Full screen: Retina copy 4,784 tokens, Copy for Agents 1,874 tokens (61% fewer). 600 by 400 point region: 1,280 versus 320 tokens (75% fewer).

A Mac screenshot is Retina: every point on screen is 2x2 pixels, and models charge for images by pixel area. Copy for Agents (the ✨ button, or ⇧ Enter) and snip shot --small send 1 pixel per screen point instead.

Correct answers out of 46 by pixels per point: 45 at 2x, 1.5x, 1x and 0.8x, 46 at 0.7x, then 43 at 0.6x and 38 at 0.5x. Tokens per screenshot fall from 4,784 at 2x to 1,728 at 1x.

Fewer pixels, same answers. We showed two dense screens at seven sizes to fresh Claude Opus 5.5 agents and asked 46 questions with exact answers. Reading holds down to 0.7 pixels per point and starts to fail at 0.6, so 1 pixel per point leaves a wide margin. The one miss above that was the same at every size (0O read as 00 in a monospace font), and the agent never gave a wrong answer while saying it was sure.

The numbers
Pixels per point 2 (Retina) 1.5 1 (for agents) 0.8 0.7 0.6 0.5
Wrong answers (of 46) 1 1 1 1 0 3 8
Tokens, 1440×900-point screen 4,784 3,888 1,728 1,106 847 622 432

Tokens are estimated with Anthropic's formula for Claude: width × height ÷ 750, at most about 4,784 per image on current models, which shrink anything larger first. Pages, questions, answers and images: Benchmarks/legibility.

Speed

Median time per screenshot. Full screen: snip 376 ms, screencapture 775, python mss 693 (1x only), Peekaboo 1,127. Region: 291, 611, 499, 1,017. Window: 453, 827, mss not supported, Peekaboo 5,527.

Agents take a lot of screenshots, each one a fresh process, so snip shot is built to be quick. The Mac was busy during the run (load average 25 to 60), so every number is high, but the order held in every run. On an idle Mac a full-screen snip shot takes about 200 ms. Measure your own Mac with python3 Benchmarks/bench.py.

The numbers, and where the time went
snip 0.2 screencapture python mss Peekaboo 4.9
Full screen 376 ms 775 ms 693 ms (1x only) 1,127 ms
Region 291 ms 611 ms 499 ms (1x only) 1,017 ms
Window 453 ms 827 ms not supported 5,527 ms

Apple M1, macOS 27, 2880×1800 display.

Where the time went:

  • No app setup. snip never starts an AppKit app for a screenshot.
  • Screens and regions come straight from ScreenCaptureKit's rect capture, without listing every window first.
  • Windows use CoreGraphics' window capture, which skips the session ScreenCaptureKit sets up for each new process (with a ScreenCaptureKit fallback).
  • PNGs are compressed on every core at once. Lossless, and smaller than macOS's own encoder.

Why

If you've used the screenshot tool in Lark, you know the flow: one hotkey, the screen freezes, you click the window you want, draw a box and an arrow, and hit Enter. It's on your clipboard before you've thought about it.

Snip brings that flow to the Mac as a tiny native menu bar app. There's no Electron, no account, and no uploads. Then it hands the same tools to your coding agent, so it can look at your screen and show you what it means instead of describing it.

Features

Mark it up Hide what's private
Mark it up. Rectangles, ellipses, arrows, freehand ink, text, and numbered steps. Six colors, three sizes. Hold Shift to keep shapes even and arrows straight. Hide what's private. Brush a mosaic over passwords, emails, and account numbers before you share.
Pin it on top Everything stays on your Mac
Pin it on top. Float a snip above your other windows while you write, code, or compare. Drag to move, scroll to zoom. Stays on your Mac. Text recognition runs on device with Apple's Vision framework. Snip makes no network requests.

Scrolling screenshot of a chat with a live preview, and a screen recording of a dashboard region with pause and stop controls

Scroll it. Record it. Select a region and press the scroll button: scroll at your own pace and Snip stitches one long image as you go, keeping sticky headers and sidebars out of the middle. Or press record for an MP4 of any region, with pause, resume, and ⌘ ⇧ A to stop.

Also included:

  • Smart window snapping. Every display freezes and the window under the cursor lights up. Click to grab it, or drag any region.
  • Pixel-exact framing. A magnifier shows coordinates and color. Press C to copy the hex value.
  • Adjustable selection. Eight resize handles, drag to move, and arrow keys to nudge by 1 px (10 px with Shift).
  • Extract text. On-device OCR copies the words in any snip.
  • Scrolling screenshots. Select a region, press the scroll button, and scroll. Snip stitches one long image and handles sticky headers, footers, and sidebars.
  • Screen recording. Record any region to MP4, with pause. Snip's own controls stay out of the video.
  • Save or copy. Save a PNG with ⌘ S, or copy with Enter.
  • Copy for Agents. The ✨ button (or ⇧ Enter) copies 1 pixel per screen point instead of Retina's 2: up to 75% fewer image tokens in Claude, ChatGPT or Claude Code, and the agent reads it just as well. Enter still copies full resolution.

Keyboard shortcuts

While capturing
⌘ ⇧ A Start a capture from anywhere
Click Snap the highlighted window
Drag Select a region
C Copy the color under the cursor
← → ↑ ↓ Nudge the selection (hold ⇧ for 10 px)
Shift while drawing Even shapes, straight arrows
⌘ Z Undo
Enter, ⌘ C, or double-click Copy to clipboard and finish
⇧ Enter or ⌘ ⇧ C Copy for Agents (smaller image, same detail) and finish
⌘ S Save as PNG
Right-click Reset the selection
Esc Cancel
Pinned snips
Drag Move
Scroll Zoom
⌘ C / ⌘ ⇧ C / ⌘ S Copy / Copy for Agents / Save
Right-click Copy, Save, Close
Double-click or Esc Close

Privacy

Snip captures only when you ask it to, and records video only after you press Record. Screenshots, annotations, and recognized text stay on your Mac. There's no analytics, no account, and no network access. The App Store build runs in the App Sandbox. See the privacy policy.

For agents

snip is the same capture, stitching, recording, and markup as a command-line tool, so coding agents (Claude Code, Codex, Cursor, anything with a shell) can see your screen and show you things.

A dashboard screenshot marked by an agent: the churn card boxed and numbered, an arrow and a note saying Churn went up. Worth a look?, and the week 11 bar circled
Marked up by an agent with snip mark.

./install-cli.sh                                  # installs ~/.local/bin/snip
snip shot --app Safari                            # screenshot a window
snip shot --app Safari --small                    # same, sized for a model (see Tokens)
snip scroll --app Slack                           # the whole scrolling window, one long image
snip record --app "My App" --background           # start a video; `snip stop` ends it
snip ocr shot.png --json                          # text with pixel boxes
snip mark shot.png --box 120,340,400,90 --step 140,360 --text 600,360,"This one"
snip pin shot.marked.png                          # float it on your screen

Every command prints the file it wrote (--json for details). snip help lists every flag. Agents learn the tool from skills/snip/SKILL.md; with the skills CLI: npx skills add anup-a/screenshot-for-agents.

The command-line tool needs Screen Recording permission for your terminal, and Accessibility for snip scroll.

Scripts can also open the app's capture by posting the distributed notification com.anup.snip.capture:

DistributedNotificationCenter.default().post(name: .init("com.anup.snip.capture"), object: nil)

Project layout

Sources/SnipKit/          shared by the app and the CLI
  Annotation.swift        shapes, mosaic, text, numbered markers, palette
  Stitcher.swift          joins scrolled frames into one long image
  RegionWriter.swift      writes screen frames to MP4
  PNGEncoder.swift        multi-core PNG encoder
Sources/SnipCLI/          the `snip` command-line tool
Sources/Snip/
  AppDelegate.swift       menu bar item, hotkey, launch at login
  HotKey.swift            global ⌘⇧A registration
  ScreenCapturer.swift    freezes every display
  CaptureSession.swift    one capture from hotkey to output
  OverlayView.swift       selection, window snapping, magnifier, drawing
  Toolbar.swift           tool, color, and size pickers
  Output.swift            clipboard, PNG save, OCR, toasts
  PinWindow.swift         floating pinned snips
  LiveRegion.swift        dimmed region, live control bar, result windows
  ScrollCapture.swift     scrolling screenshot
  ScreenRecorder.swift    region recording
  PermissionWindow.swift  guided Screen Recording setup
  DemoRenderer.swift      renders overlay states for marketing images
Marketing/
  html/                   App Store screenshots as HTML (render.sh)
  appstore-v2/            rendered 2880×1800 screenshots
  readme/                 README images and the demo video as HTML (render.sh)
  APP_STORE.md            store listing copy
skills/snip/SKILL.md      how agents use `snip`
archive.sh                sandboxed Mac App Store build
install-cli.sh            builds and installs `snip`
Benchmarks/bench.py       screenshot CLI benchmark

Not yet

  • Snapping to individual buttons or panels inside a window (only whole windows for now)

Issues and pull requests are welcome.

License

MIT © 2026 Anup Aglawe


Not affiliated with Lark or ByteDance. "Lark-style" describes the workflow that inspired Snip.

About

Screenshots for AI agents and you: a Mac screenshot app + CLI. Up to 75% fewer image tokens with no detail lost, about 2x faster than screencapture.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages