What it does

Send peepshow runs to Zulip as markdown messages, addressed to a stream topic or a private DM. Optional `ZULIP_IMAGE_BASE` embeds frames inline using markdown image syntax; otherwise frames are listed as a bullet list of paths.

When to reach for it

Threaded discussion of a specific video under a Zulip topic
Private DM mode (`ZULIP_TYPE=private`) for 1:1 triage
Bot integrations that read Zulip topics for downstream automation

Install

npm i -g peepshow

Use it

ZULIP_SITE=https://myorg.zulipchat.com \
ZULIP_EMAIL=bot@myorg.zulipchat.com \
ZULIP_API_KEY=... \
ZULIP_STREAM=engineering \
peepshow ./clip.mp4 --sink zulip

Make it automatic

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

Configuration

ZULIP_SITE Org URL, e.g. `https://myorg.zulipchat.com`. required
ZULIP_EMAIL Bot email (Basic auth user). required
ZULIP_API_KEY Bot API key (Basic auth password). required
ZULIP_STREAM Stream name, or comma-separated emails for private DMs. required
ZULIP_TOPIC Topic name for stream messages. Default `peepshow`.
ZULIP_TYPE `stream` or `private`. Default `stream`.
ZULIP_IMAGE_BASE URL prefix — embeds frames inline as markdown images.
ZULIP_MAX_IMAGES Cap on embedded images. Default `8`.

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 Zulip 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 ZULIP_SITE="..."
export ZULIP_EMAIL="..."
export ZULIP_API_KEY="..."
export ZULIP_STREAM="..."

2. Register as an auto-sink

peepshow sinks add zulip
peepshow sinks add zulip --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 Zulip sink forwards the run to the configured channel. Claude replies with a summary and a link to the created record.

The transcript snippet is posted alongside the frames as a secondary message.

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'.

Zulip — Post every run to a Zulip stream topic or DM.