What it does

Aider keeps a running transcript of its pair-programming session in a local markdown file (`.aider.chat.history.md`). This sink appends a structured peepshow block — summary, container tags, absolute frame paths, and optional `mm:ss` transcript — so the next aider load sees the video alongside the rest of the dialogue.

When to reach for it

Keep aider video-aware without leaving the terminal
Drop bug-recording clips into the running aider session as evidence
Archive every processed clip under `AIDER_ROOT` as a standalone per-run markdown

Install

npm i -g peepshow

Use it

peepshow ./bug.mov --sink aider
# or use a specific history file:
AIDER_CHAT_HISTORY_FILE=~/projects/app/.aider.chat.history.md \
peepshow ./bug.mov --sink aider

Make it automatic

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

Configuration

AIDER_CHAT_HISTORY_FILE Path (absolute or relative to cwd) to aider's chat history file. Default `./.aider.chat.history.md`.
PEEPSHOW_AIDER_FILE Alias for `AIDER_CHAT_HISTORY_FILE`.
AIDER_ROOT Write a standalone `peepshow-<timestamp>.md` under this directory instead of appending to a chat history file.

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 Aider 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:

peepshow ./bug.mov --sink aider
# or use a specific history file:
AIDER_CHAT_HISTORY_FILE=~/projects/app/.aider.chat.history.md \
peepshow ./bug.mov --sink aider

2. Register as an auto-sink

peepshow sinks add aider
peepshow sinks add aider --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 Aider sink forwards the run to the configured Aider 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'.

Aider — Append every run into Aider's chat history markdown.