Windsurf — Cascade rules pick up peepshow without config.

How it plugs in

Windsurf follows the `.windsurf/rules/` convention for project-level agent guidance. peepshow ships a Cascade-compatible rule so the agent knows to invoke the CLI on video inputs and how to interpret the output.

Install

git clone --depth 1 https://github.com/t0mtaylor/peepshow.git
# rule at .windsurf/rules/peepshow.md is picked up automatically.

Files involved

• .windsurf/rules/peepshow.md Cascade-compatible agent rule.

In practice

# Drop a video path into Cascade — peepshow fires.
user: summarise this → /Users/you/clip.mov
agent: (runs peepshow) → frame-grounded summary

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 Windsurf 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":"windsurf"}' \
  | peepshow report annotate "<outputDir>"

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