AGENTS.md — Zed AI · Codex Agents · GitHub Copilot — convention-based pickup.

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.md Repo-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 95 sinks still work

The CLI is the same across agents — which means every sink documented under /sinks is available here. Auto-sinks fire regardless of which agent invoked peepshow.

Report + LLM analysis loop

Every run also writes a self-contained report.html + manifest.json next to the frames (see the Report page). When AGENTS.md consumes the frames, the analysis flows back into the report so whoever opens it next sees the model's understanding without re-running the prompt.

echo '{"summary":"<your summary>","provider":"agents-md"}' \
  | peepshow report annotate "<outputDir>"

The annotate instruction is wired into the AGENTS.md integration — the agent runs it after reading the frames + transcript. Report walkthrough →