What it does
Your vault becomes the long-term memory. peepshow writes one markdown note per run under a configurable folder, copies the frames into the attachments folder, and optionally appends to a rolling index note so new entries show up without plugins.
When to reach for it
- Personal research — every dropped video becomes a dated note with frames inline
- Agent memory — point Claude / Cursor at the same vault so it can read notes about videos it's already seen
- Build an offline, portable, single-source archive of everything an LLM has watched
Install
npm i -g peepshowUse it
peepshow ./lecture.mp4 --sink obsidian \
--sink-arg vault=~/Documents/Vault \
--sink-arg folder=peepshowMake it automatic
Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.
peepshow sinks add obsidian
peepshow sinks add obsidian --when extension=mp4,mov
peepshow sinks add obsidian --when path=/Volumes/Work/Configuration
PEEPSHOW_OBSIDIAN_VAULTAbsolute path to the vault root. requiredPEEPSHOW_OBSIDIAN_FOLDERSubfolder inside the vault. Default `peepshow`.PEEPSHOW_OBSIDIAN_INDEXOptional rolling index note filename.
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 Obsidian 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 PEEPSHOW_OBSIDIAN_VAULT="..."2. Register as an auto-sink
peepshow sinks add obsidian
peepshow sinks add obsidian --when extension=mp4,mov3. Example LLM session
You → drop a
.movinto Claude Code.Claude → auto-invokes
/peepshow:slides ./clip.mov. peepshow extracts frames + audio, theObsidiansink forwards the run to a new page in your knowledge base. Claude replies with a summary and a link to the created record.
The transcript text is embedded alongside the frame gallery on the created page.
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'.