peepshow/ agents

Catalogue 8 agent runtimes

peepshow meets every LLM CLI

One CLI. Every agent.

peepshow ships native manifests, hooks, and rules for the major LLM CLIs — so once it's installed, dragging a video into any of them just works. No per-agent glue.

drop · process · annotate · fan-out
Reel #A-01 · Claude Code plugin

Claude Code

Full plugin: `/peepshow:slides` slash command, UserPromptSubmit hook, statusline badge, all 95 sinks.

The reference integration — drag-and-drop auto-invoke included.
Reel #A-02 · Cursor integration

Cursor

Drop peepshow into a project, `.cursor/rules/peepshow.mdc` makes the Cursor agent aware of the CLI and when to invoke it.

Project-level rules auto-load when peepshow is installed.
Reel #A-03 · Windsurf Cascade

Windsurf

`.windsurf/rules/peepshow.md` teaches Windsurf's Cascade agent to reach for peepshow on video paths.

Cascade rules pick up peepshow without config.
Reel #A-04 · Cline CLI agent

Cline

Cline reads `.clinerules/` at project root. peepshow's rule documents the CLI and the invocation contract.

`.clinerules/` convention — zero setup.
Reel #A-05 · OpenAI Codex CLI

Codex CLI

`.codex/hooks.json` + `.codex/config.toml` — Codex CLI runs a hook on start, tells the model about peepshow, invokes it via Bash.

SessionStart hook announces peepshow to the model.
Reel #A-06 · Google Gemini CLI

Gemini CLI

`gemini-extension.json` registers peepshow as a custom tool; `GEMINI.md` tells the model when to reach for it.

Custom extension + GEMINI.md instruction file.
Reel #A-07 · Generic convention

AGENTS.md

A single `AGENTS.md` at repo root is the emerging convention. peepshow's includes everything a generic LLM agent needs to use the CLI.

Zed AI · Codex Agents · GitHub Copilot — convention-based pickup.
Reel #A-08 · Generic registry

Agents Marketplace

`.agents/plugins/marketplace.json` — the early-days cross-agent plugin catalogue format. peepshow is pre-registered.

Cross-agent plugin registry (emerging).

Report + LLM analysis loop

Every peepshow run writes a self-contained report.html + manifest.json next to the frames, with optional per-frame captions. The agent that consumed the frames pipes its synthesis back via peepshow report annotate so the next viewer sees the model's understanding without re-running the prompt:

echo '{"summary":"<2-4 sentences>","provider":"<agent>","model":"<model-id>"}' \
  | peepshow report annotate "<outputDir>"

Wired into every agent integration — see the per-agent rule files (skills/slides/SKILL.md, .cursor/rules/peepshow.mdc, .windsurf/rules/peepshow.md, .clinerules/peepshow.md, .codex/hooks.json, AGENTS.md). Full report walkthrough →