Name: peepshow Apple Reminders sink
Author: Tom Taylor

What it does

Apple's Reminders.app is the macOS-native task tracker — synced for free across iOS, iPadOS, watchOS, and the Mac via iCloud. This sink turns every peepshow run into a follow-up task there: the body is plain text (Reminders won't render HTML — different from Notes), the name is derived from `video.tags.title` / `video.tags.show` or a UTC-stamped fallback, frame paths land in a `Frames:` block, and transcript segments are inlined as `mm:ss text` (capped at 6 with a `(N more)` tail). Optionally set a due date by configuring `APPLE_REMINDERS_DUE_HOURS` — peepshow computes the absolute moment from `now + hours` so the reminder shows up in the Reminders sidebar at the right time. No API keys, no cloud plumbing — uses whatever Reminders account is already signed in. Skips silently on non-darwin unless `APPLE_REMINDERS_ALLOW_NON_DARWIN=1` is set.

When to reach for it

Personal triage — every extracted clip becomes a follow-up task with a due date
Cross-device task inbox: iCloud syncs the reminder to your iPhone / iPad / Watch automatically
PM-style workflow where each video an agent processes lands as a reviewable to-do

Install

npm i -g peepshow

Use it

APPLE_REMINDERS_LIST="Watch later" \
APPLE_REMINDERS_DUE_HOURS=24 \
peepshow ./lecture.mp4 --sink apple-reminders

Make it automatic

peepshow sinks add apple-reminders
peepshow sinks add apple-reminders --when extension=mp4,mov
peepshow sinks add apple-reminders --when path=/Volumes/Work/

Configuration

APPLE_REMINDERS_LIST List name inside Reminders.app. Default `Reminders`.
PEEPSHOW_APPLE_REMINDERS_LIST Alias for `APPLE_REMINDERS_LIST`; wins when both are set.
APPLE_REMINDERS_TITLE Override the derived reminder name.
APPLE_REMINDERS_DUE_HOURS Integer hours from now to set as the due date. Unset → no due date. Negative values allowed (past-due reminders).
APPLE_REMINDERS_ALLOW_NON_DARWIN `1` to force-run on non-darwin platforms (CI / debug).

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 Apple Reminders sink automatically when three things are true:

the env vars below are exported in the agent's shell (or a project .env it can load),
the peepshow CLI is on PATH — install with npm i -g peepshow,
a peepshow auto-sink is registered for the run (optional but recommended — makes invocation zero-argument).

1. Set the environment

This sink has no required env vars — it writes to a local path. Pass the destination via --sink-arg:

APPLE_REMINDERS_LIST="Watch later" \
APPLE_REMINDERS_DUE_HOURS=24 \
peepshow ./lecture.mp4 --sink apple-reminders

2. Register as an auto-sink

peepshow sinks add apple-reminders
peepshow sinks add apple-reminders --when extension=mp4,mov

3. Example LLM session

You → drop a .mov into Claude Code.
Claude → auto-invokes /peepshow:slides ./clip.mov. peepshow extracts frames + audio, the Apple Reminders sink forwards the run to the configured Apple Reminders target. Claude replies with a summary and a link to the created record.

The transcript rides along in the payload whenever the audio pass transcribes successfully.

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'.

Apple Reminders — Create a reminder (todo task) in Apple Reminders.app on macOS.