peepshow/agents/codex

Reel #A-05◆OpenAI Codex CLI◆2026-04-22

peepshow for agents / codex

Codex CLI—SessionStart hook announces peepshow to the model.

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

How it plugs in

Codex CLI's hook system is a natural fit: the SessionStart hook emits a one-line reminder about peepshow into the model's context. When Codex sees a video path, it uses its Bash tool to call the CLI.

Install

git clone --depth 1 https://github.com/t0mtaylor/peepshow.git
# Codex picks up .codex/hooks.json + .codex/config.toml on next session.

Files involved

.codex/hooks.jsonSessionStart hook — announces peepshow.
.codex/config.tomlOptional default flags and sink presets.

In practice

user: open bug-report.mov
codex: (Bash: peepshow ./bug-report.mov --emit json) → frames → answer

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.