What it does
[Otter.ai](https://otter.ai) is the AI meeting-notes service. Its write surface in 2026 is the [official Zapier app](https://help.otter.ai/hc/en-us) — Otter exposes no public REST write API. This sink ships the upstream half of the pipeline: it POSTs the peepshow run summary (plus optional whisper transcript) to a user-configured webhook URL. The user wires the downstream half — Zapier `Catch Hook` → Otter `Create Note`, or the equivalent in Make / n8n. The body is a flat JSON object (`meeting_title` · `note` · `transcript` · `duration` · `frames` · `thumbnail_url` · `tags` · `created_at`) so the Zapier/Make field-mapper picks every field up without nested object parsing.
When to reach for it
- Have every screen-recording walkthrough land in your team's Otter workspace alongside actual meetings
- Bridge peepshow runs into any Otter-adjacent workflow — Slack share, Notion meeting-notes db, calendar event
- Pair with `--when` so only specific videos (e.g. `--when extension=mov,mp4`) trigger the Otter note
Install
npm i -g peepshowUse it
# 1. In Zapier: create a 'Webhooks by Zapier' Catch Hook → wire to 'Otter.ai - Create Note'
# 2. Copy the catch-hook URL into OTTER_WEBHOOK_URL:
OTTER_WEBHOOK_URL="https://hooks.zapier.com/hooks/catch/123/abc/" \
peepshow ./standup.mov --sink otterMake it automatic
Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.
peepshow sinks add otter
peepshow sinks add otter --when extension=mp4,mov
peepshow sinks add otter --when path=/Volumes/Work/Configuration
OTTER_WEBHOOK_URLDestination webhook URL — typically a Zapier `Catch Hook`, Make webhook, or n8n webhook trigger wired into Otter. requiredOTTER_TITLE_PREFIXPrefix prepended to the note title. Default `peepshow`. Set to empty string to omit.OTTER_AUTHOptional verbatim `Authorization` header value (e.g. `Bearer …`) sent to the webhook. Useful for self-hosted glue or Make scenarios with auth.PEEPSHOW_FRAME_BASE_URLWhen set, the first frame URL is written to the `thumbnail_url` field.
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 Otter.ai 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 OTTER_WEBHOOK_URL="..."2. Register as an auto-sink
peepshow sinks add otter
peepshow sinks add otter --when extension=mp4,mov3. Example LLM session
You → drop a
.movinto Claude Code.Claude → auto-invokes
/peepshow:slides ./clip.mov. peepshow extracts frames + audio, theOtter.aisink forwards the run to the configured Otter.ai 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'.