Linear—Open an issue with the video evidence attached.

What it does

Turn a video into a triaged Linear issue automatically: title and description from container metadata, frames attached as image uploads, configurable team/project/priority.

When to reach for it

• Bug-report videos from users become actual issues, ready for engineering
• Support team drops screen recordings; agent files and links them into Linear
• Pair with the `--when` router: only file issues for videos from specific paths

Install

npm i -g peepshow

Use it

peepshow ./bug.mov --sink linear \
  --sink-arg team=ENG \
  --sink-arg priority=2

Make it automatic

Register the sink once — every run fires it afterward. Scope by--whenso it only runs for matching videos.

peepshow sinks add linear
peepshow sinks add linear --when extension=mp4,mov
peepshow sinks add linear --when path=/Volumes/Work/

Configuration

• PEEPSHOW_LINEAR_TOKENLinear API key with issue-creation scope.required
• PEEPSHOW_LINEAR_TEAMDefault team key if `--sink-arg team` is omitted.

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'.