Coda — One row per run in a Coda doc table — the no-code wiki / database hybrid.

What it does

[Coda](https://coda.io) blends a doc, spreadsheet, and database in one canvas — teams use it for project trackers, OKRs, content pipelines, and lightweight CRMs. This sink writes every peepshow run as one row in a chosen doc + table via `POST /apis/v1/docs/<docId>/tables/<tableId>/rows` with the standard `{rows: [{cells: [{column, value}, ...]}]}` shape. Columns must exist on the table (Coda's API doesn't auto-create schema). Once wired up the rows flow into any Coda automation, pack, or dashboard you've built — a queryable log that non-engineer stakeholders can shape into views without leaving the doc they already live in.

When to reach for it

• Maintain a stakeholder-friendly log of every video an agent processed — Coda views beat SQL for non-engineers
• Trigger Coda automations (Slack post, email, pack action) on each new peepshow run
• Drop runs into a Coda dashboard alongside your project tracker — no extra UI needed

Install

npm i -g peepshow

Use it

CODA_API_KEY="codaKEYxxxxxxxxxxxxxxxxxxxxxxxx" \
CODA_DOC_ID="abc123XYZ" \
CODA_TABLE_ID="grid-xxxxxxxx" \
peepshow ./demo.mp4 --sink coda

Make it automatic

Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.

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

Configuration

• CODA_API_KEY Coda API token (Bearer auth). Generate at [coda.io/account](https://coda.io/account). required
• CODA_DOC_ID Doc id — the segment after `_d` in the doc URL (e.g. `https://coda.io/d/My-Doc_dXYZ123` → `XYZ123`). required
• CODA_TABLE_ID Table id (preferred — survives renames). Find via `GET /docs/<doc>/tables`.
• CODA_TABLE_NAME Human-readable table name. Used when `CODA_TABLE_ID` is unset.
• CODA_API_URL Override the base URL — useful for proxies.
• PEEPSHOW_FRAME_BASE_URL When set, the first frame URL is written to the `Thumbnail URL` column.

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

peepshow sinks add coda
peepshow sinks add coda --when extension=mp4,mov

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