What it does

[Things 3](https://culturedcode.com/things/) is the polished GTD-flavoured task manager from Cultured Code. This sink turns every peepshow run into a todo there: the title is derived from `video.tags.title` / `video.tags.show` or a `peepshow run (N frames)` fallback; the notes body lists frame count, strategy, duration, resolution, codec, container tags, and the first transcript segment as a snippet when peepshow's audio pass produced one. Tags default to `peepshow` and merge with whatever you set in `THINGS_TAGS`. Optional `THINGS_LIST` / `THINGS_WHEN` route the todo into a specific project / area + schedule (`today` · `tomorrow` · `evening` · `anytime` · `someday` · `YYYY-MM-DD`). Skips silently on non-darwin unless `THINGS_ALLOW_NON_DARWIN=1` is set.

When to reach for it

Personal triage on macOS where Things is your trusted inbox — every clip becomes a reviewable todo
Cross-device sync via Things Cloud: the todo lands on your iPhone / iPad seconds after extraction
GTD-flavoured workflow where peepshow runs feed straight into the project / area / when buckets you already use

Install

npm i -g peepshow

Use it

THINGS_LIST="Bug Triage" \
THINGS_WHEN=today \
THINGS_TAGS="bug,clip" \
peepshow ./bug.mov --sink things

Make it automatic

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

Configuration

THINGS_TITLE Override the derived title.
PEEPSHOW_THINGS_TITLE Alias for `THINGS_TITLE`; wins when both are set.
THINGS_NOTES_PREFIX Prepended to the notes body, separated by a blank line.
THINGS_TAGS Comma-separated extra tags. Always merged with the default `peepshow` tag — duplicates collapse.
THINGS_LIST Project / area name in Things to file the todo under.
THINGS_WHEN `today` · `tomorrow` · `evening` · `anytime` · `someday` · ISO-date `YYYY-MM-DD`.
THINGS_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 Things 3 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:

THINGS_LIST="Bug Triage" \
THINGS_WHEN=today \
THINGS_TAGS="bug,clip" \
peepshow ./bug.mov --sink things

2. Register as an auto-sink

peepshow sinks add things
peepshow sinks add things --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 Things 3 sink forwards the run to the configured Things 3 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'.

Things 3 — Create a todo in Things 3 (Cultured Code) on macOS via the things:/// URL scheme.