How it plugs in
The `AGENTS.md` convention — now supported by Zed AI, Codex Agents, Warp, and the incoming GitHub Copilot agent mode — is the lowest-common-denominator instruction file. peepshow's covers the CLI, the output schemas, and the invocation contract so any AGENTS.md-aware agent can use it.
Install
# peepshow's AGENTS.md sits at repo root.
git clone --depth 1 https://github.com/t0mtaylor/peepshow.git
# any AGENTS.md-aware agent reads it automatically.Files involved
AGENTS.mdRepo-root instructions: what peepshow is, how to call it, how to interpret output.
In practice
# Any AGENTS.md-aware tool:
user: analyse demo.mp4
agent: (reads AGENTS.md → runs peepshow → reads frames)All 19 sinks still work
The CLI is the same across agents — which means every sink documented under/sinksis available here. Auto-sinks fire regardless of which agent invoked peepshow.