What it does

Push every frame plus a `manifest.json` to a Supabase Storage bucket via its REST endpoint. No SDK, no runtime dependencies — works identically against hosted Supabase projects and self-hosted installs.

When to reach for it

Supabase-first apps that already use the project's Storage bucket
Self-hosted Supabase: point `SUPABASE_URL` at your instance
Pair with Supabase's Edge Functions for serverless post-processing

Install

npm i -g peepshow

Use it

SUPABASE_URL=https://abc.supabase.co \
SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOi... \
SUPABASE_BUCKET=peepshow-archive \
peepshow ./clip.mp4 --sink supabase

Make it automatic

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

Configuration

SUPABASE_URL Project URL, e.g. `https://abc.supabase.co`. required
SUPABASE_SERVICE_ROLE_KEY Service role key (bypasses RLS — keep server-side). required
SUPABASE_BUCKET Target bucket name. required
SUPABASE_PREFIX Key prefix applied to every upload. Default `peepshow/`.

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 Supabase Storage 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 SUPABASE_URL="..."
export SUPABASE_SERVICE_ROLE_KEY="..."
export SUPABASE_BUCKET="..."

2. Register as an auto-sink

peepshow sinks add supabase
peepshow sinks add supabase --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 Supabase Storage sink forwards the run to the configured bucket / folder. Claude replies with a summary and a link to the created record.

The full transcript JSON is saved next to the frames in the manifest.

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

Supabase Storage — Upload frames and manifest to a Supabase Storage bucket.