Gemini CLI — Custom extension + GEMINI.md instruction file.

How it plugs in

Gemini CLI supports custom extensions via a manifest file. peepshow ships `gemini-extension.json` so Gemini can invoke it like a tool, and `GEMINI.md` provides in-context instructions for when to use it.

Install

git clone --depth 1 https://github.com/t0mtaylor/peepshow.git
cd peepshow
gemini --extension .  # or add to your global extensions directory

Files involved

• gemini-extension.json Manifest describing the peepshow tool and its arguments.
• GEMINI.md Model-facing instructions and invocation examples.

In practice

user: summarise demo.mp4
gemini: (calls peepshow tool → reads frames → replies)

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 Gemini CLI 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":"gemini"}' \
  | peepshow report annotate "<outputDir>"

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