What it does

File peepshow runs into Confluence Cloud as pages under a space. Body is storage-format XHTML (Metadata section + Frames list); auth is basic (email + API token); pages can be nested under an existing parent.

When to reach for it

Enterprise wiki where video references live alongside specs and runbooks
Per-space archives: route specific clips into specific spaces with `--when`
Nest under a parent page via `CONFLUENCE_PARENT_PAGE_ID` for structure

Install

npm i -g peepshow

Use it

CONFLUENCE_BASE_URL=https://you.atlassian.net \
CONFLUENCE_USER=me@example.com \
CONFLUENCE_API_TOKEN=... \
CONFLUENCE_SPACE_ID=1234 \
peepshow ./clip.mp4 --sink confluence

Make it automatic

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

Configuration

CONFLUENCE_BASE_URL Atlassian instance URL, e.g. `https://you.atlassian.net`. required
CONFLUENCE_USER Email for basic auth. required
CONFLUENCE_API_TOKEN API token. required
CONFLUENCE_SPACE_ID Numeric space id (preferred by v2). Required unless `CONFLUENCE_SPACE_KEY` is set.
CONFLUENCE_SPACE_KEY Alphanumeric space key — fallback if no id.
CONFLUENCE_PARENT_PAGE_ID Nest under an existing page.

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 Confluence 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 CONFLUENCE_BASE_URL="..."
export CONFLUENCE_USER="..."
export CONFLUENCE_API_TOKEN="..."

2. Register as an auto-sink

peepshow sinks add confluence
peepshow sinks add confluence --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 Confluence 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'.

Confluence — Create a Confluence page per run.