peepshow/agents/agents-md

Reel #A-07Generic convention

peepshow for agents / agents-md

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

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

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.