---
slug: "pi-screenshots"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/affsantos/pi-screenshots@main/README.md"
repo: "https://github.com/affsantos/pi-screenshots"
source_file: "README.md"
branch: "main"
---
# pi-screenshots

Screenshot picker for [pi](https://pi.dev) — browse, capture, and attach screenshots to your prompts.

## Install

```bash
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`:
   ```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