# screenpunk

Fetch recent screenshots from your local workstation and/or remote cloud storage.

## Requirements

- `~/.screenpunk` config file (created when you sync via screenpunk.matraex.com)
- Screenshots in `~/screenpunk/screenshots/` (Mac/Linux) or `C:\screenpunk\screenshots\` (Windows)

## When to use

User says things like: "check screenpunk", "show my latest screenshot", "what's in screenpunk?", "look at my latest screenpunks"

## Run

Mac/Linux:
!screenpunk_skill.sh

Windows:
!screenpunk_skill.bat

## Output format

JSON with two keys:
- `local` — array of file paths on the local machine
- `remote` — array of CDN URLs from cloud storage

```json
{"local":["/home/user/screenpunk/screenshots/screen-20260222-143022.png"],"remote":["https://cdn.screenpunk.matraex.com/screenshots/screen-20260222-143022.png"]}
```

## How to use the output

1. Run the skill script to get the JSON output
2. Read the most recent local file path or remote CDN URL
3. Use the Read tool to view the image and show it to the user
4. If both local and remote are empty, tell the user no screenshots were found

## Config file setup

The `~/.screenpunk` config is created automatically when you run `?remotelocationsync=CODE` from the screenpunk website. If it is missing, visit https://screenpunk.matraex.com/ to connect.

Config format (`~/.screenpunk`):
```json
{
  "code": "CODEFROMSERVER",
  "connecteddatetime": "2026-02-22 12:00:00",
  "accountname": "Your Name",
  "accountemail": "you@example.com"
}
```

## Notes

- Local screenshots are listed newest first
- Remote CDN URLs require a `code` in the config and a configured Lambda endpoint
- Run history is appended to `~/.screenpunk.skill.run` after each run