What it does
[Pushover](https://pushover.net) is a paid push-notification service (one-time per-platform cost, no subscription) that delivers messages to iOS, Android, and desktop clients within seconds. This sink calls `POST /1/messages.json` with form-encoded `token`, `user`, `title`, `message`, and an optional `priority` between -2 (silent) and 2 (emergency). When `PEEPSHOW_FRAME_BASE_URL` is set, the first frame URL is sent as `url` so Pushover renders a clickable Open Frame action under the notification. Target specific devices with `PUSHOVER_DEVICE=iphone,ipad` — otherwise the message fans out to every device registered on the account.
When to reach for it
- Get a Pushover ping the moment a long-running agent finishes processing a clip
- Wake yourself up on critical clips with priority=2 (emergency-bypass)
- Send a thumbnail link straight to the lock screen so a reviewer can tap through without opening the agent UI
Install
npm i -g peepshowUse it
PUSHOVER_USER_KEY="uXXXXXXXXXXXXXXXXXXXXXX" \
PUSHOVER_API_TOKEN="aXXXXXXXXXXXXXXXXXXXXXX" \
PUSHOVER_PRIORITY=1 \
peepshow ./clip.mp4 --sink pushoverMake it automatic
Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.
peepshow sinks add pushover
peepshow sinks add pushover --when extension=mp4,mov
peepshow sinks add pushover --when path=/Volumes/Work/Configuration
PUSHOVER_USER_KEYUser or group key from [pushover.net](https://pushover.net). requiredPUSHOVER_API_TOKENApplication API token — create one under [Your Applications](https://pushover.net/apps/build). requiredPUSHOVER_DEVICEComma-separated device names (e.g. `iphone,ipad`). Defaults to every registered device.PUSHOVER_PRIORITY-2..2 (`-2`=lowest/silent, `0`=normal, `2`=emergency-bypass). Default `0`.PUSHOVER_TITLE_PREFIXPrepended to the notification title. Default `peepshow`.PUSHOVER_API_URLOverride the base URL — useful for proxies or testing.PEEPSHOW_FRAME_BASE_URLWhen set, the first frame URL is sent as Pushover's `url` field — Pushover renders it as a clickable action under the notification.
Use with an LLM agent
Every peepshow sink reads its config from env vars and receives a single JSON payload on stdin. An LLM agent (Claude Code, Cursor, Windsurf, Gemini, Codex) can drive the Pushover sink automatically when three things are true:
- the env vars below are exported in the agent's shell (or a project
.envit can load), - the
peepshowCLI is onPATH— install withnpm i -g peepshow, - a peepshow auto-sink is registered for the run (optional but recommended — makes invocation zero-argument).
1. Set the environment
# Add to ~/.zshrc, ~/.bashrc, or a project .env the agent can load
export PUSHOVER_USER_KEY="..."
export PUSHOVER_API_TOKEN="..."2. Register as an auto-sink
peepshow sinks add pushover
peepshow sinks add pushover --when extension=mp4,mov3. Example LLM session
You → drop a
.movinto Claude Code.Claude → auto-invokes
/peepshow:slides ./clip.mov. peepshow extracts frames + audio, thePushoversink forwards the run to the configured channel. Claude replies with a summary and a link to the created record.
The transcript snippet is posted alongside the frames as a secondary message.
Write your own
A sink is any executable that reads the --emit json payload on stdin. Shell, Node, Python, Go — the spec's in docs/PLUGINS.md. Register persistent ones with peepshow sinks add-cmd 'your-command'.