What it does

Same Slack-compatible webhook shape, but wired for Rocket.Chat — summary attachment with coloured bar and metadata fields, optional image attachments via `ROCKETCHAT_IMAGE_BASE`. Channel / alias / avatar overrides all supported.

When to reach for it

Rocket.Chat-first teams who want video summaries in ops / triage channels
Multi-workspace setups: one webhook, per-call `ROCKETCHAT_CHANNEL` overrides
CDN-hosted frames: embed up to `ROCKETCHAT_MAX_IMAGES` inline in the channel

Install

npm i -g peepshow

Use it

ROCKETCHAT_WEBHOOK_URL=https://chat.example.com/hooks/... \
peepshow ./clip.mp4 --sink rocketchat

Make it automatic

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

Configuration

ROCKETCHAT_WEBHOOK_URL Incoming-webhook URL. required
ROCKETCHAT_CHANNEL Override target channel (`#room` or `@user`).
ROCKETCHAT_ALIAS Bot display name.
ROCKETCHAT_EMOJI Bot avatar emoji, e.g. `:ghost:`.
ROCKETCHAT_AVATAR Bot avatar URL.
ROCKETCHAT_IMAGE_BASE URL prefix for frame image attachments.
ROCKETCHAT_MAX_IMAGES Max image attachments. Default `4`.

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 Rocket.Chat 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 ROCKETCHAT_WEBHOOK_URL="..."

2. Register as an auto-sink

peepshow sinks add rocketchat
peepshow sinks add rocketchat --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 Rocket.Chat 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'.

Rocket.Chat — POST every run to a Rocket.Chat incoming webhook.