pi-screenshots

Screenshot picker for pi — browse, capture, and attach screenshots to your prompts.

Install

pi install git:github.com/affsantos/pi-screenshots

Usage

Command	Description
/ss	Open the screenshot picker
/ss-capture	Take a screenshot and stage it (macOS)
/ss-clear	Clear all staged screenshots
Ctrl+\	Shortcut for /ss

1. Run /ss to browse recent screenshots
2. Press Enter to stage/unstage images
3. Type your message and send — staged screenshots are automatically attached

Features

• Browse recent images with fuzzy navigation
• Stage multiple screenshots at once
• macOS screenshot capture via screencapture -i
• Widget below editor shows staged count
• Open images in system viewer with o

Configuration

Checked in order:

1. pi-screenshots.dir in ~/.pi/agent/settings.json:

   { "pi-screenshots": { "dir": "~/Screenshots" } }
   

2. PI_SCREENSHOTS_DIR environment variable
3. macOS: reads defaults read com.apple.screencapture location, falls back to Desktop
4. Linux: checks ~/Pictures/Screenshots, ~/Pictures, ~/Screenshots, ~/Desktop

License

MIT