What it does

File peepshow runs as pages inside a Logseq graph directory. Each page has top-level `key:: value` properties, a Run summary block tree, and a Frames block tree with image embeds. Frames are copied into the graph's `assets/` directory by default so they render inline without extra setup.

When to reach for it

Knowledge-graph workflow: every video becomes a page with queryable properties
Offline / mobile graphs: frames copied into the graph travel with the vault
Tags like `director` and `studio` become first-class graph properties

Install

npm i -g peepshow

Use it

LOGSEQ_GRAPH_DIR=~/logseq/brain \
peepshow ./clip.mp4 --sink logseq

Make it automatic

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

Configuration

LOGSEQ_GRAPH_DIR Absolute path to the Logseq graph directory. required
LOGSEQ_SUBDIR Subfolder under `pages/`. Default `peepshow`.
LOGSEQ_COPY `0` / `no` / `false` keeps frames outside the graph.

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 Logseq 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

# Add to ~/.zshrc, ~/.bashrc, or a project .env the agent can load
export LOGSEQ_GRAPH_DIR="..."

2. Register as an auto-sink

peepshow sinks add logseq
peepshow sinks add logseq --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 Logseq sink 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'.

Logseq — Write every run as a page into a Logseq graph.