What it does
Write the extracted frames into the editor-specific attachment directory so they can be referenced directly from a chat prompt inside the IDE. No uploads, no clipboard juggling, just images in the right folder.
When to reach for it
- Drop a video into Cursor, have the frames ready in `@` attachments a moment later
- Keep VS Code / GitHub Copilot chat video-aware via the attachments path
- Work offline — no cloud, no webhook, just files next to the IDE
Install
npm i -g peepshowUse it
peepshow ./demo.mp4 --sink ide --sink-arg editor=cursorMake it automatic
Register the sink once — every run fires it afterward. Scope by--whenso it only runs for matching videos.
peepshow sinks add ide
peepshow sinks add ide --when extension=mp4,mov
peepshow sinks add ide --when path=/Volumes/Work/Configuration
PEEPSHOW_IDE_EDITOR`cursor` · `windsurf` · `zed` · `vscode`. Default autodetect.PEEPSHOW_IDE_WORKSPACEOverride the detected workspace root.
Write your own
A sink is any executable that reads the--emit jsonpayload on stdin. Shell, Node, Python, Go — the spec's indocs/PLUGINS.md. Register persistent ones withpeepshow sinks add-cmd 'your-command'.