peepshow/ agents
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.
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 integrationCursor
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 CascadeWindsurf
`.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 agentCline
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 CLICodex 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 CLIGemini 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 conventionAGENTS.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 registryAgents 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 →