shotty

A modern macOS screenshot CLI built on ScreenCaptureKit. Capture application windows from the terminal.

Requirements

• macOS 14.0+
• Xcode Command Line Tools

Build

swiftc -O -parse-as-library -o shotty main.swift

Install

sudo cp shotty /usr/local/bin/

Permissions

shotty requires Screen Recording permission.

1. Run shotty list-apps (this triggers the permission prompt)
2. Open System Settings → Privacy & Security → Screen Recording
3. Enable the terminal app you're using (Terminal, iTerm, Ghostty, etc.)
4. Restart your terminal

Usage

shotty <command> [options]

Commands:
  capture <app|pid> [output.png]  Screenshot an app's window(s)
  list                            List all capturable windows
  list-apps                       List running applications

Options:
  --all        Capture all windows (not just first)
  --json       Output as JSON
  --no-frame   Exclude window frame/shadow

Examples

shotty capture Safari                      # screenshot.png
shotty capture Ghostty ~/Desktop/term.png  # specific path
shotty capture 12345 out.png               # by PID
shotty capture "VS Code" --all             # all windows
shotty list-apps --json                    # JSON output

Claude Code Integration

Add shotty as a skill for AI-assisted screenshots.

mkdir -p ~/.claude/skills
cp SKILL.md ~/.claude/skills/screenshot.md