Video Reader

Extract still frames from a video at a fixed interval, read them in order with vision, and report what happens — with timestamps. Primary use case: debugging UI screen recordings (drag-and-drop glitches, animation problems, layout jumps).

Step 1: Parse arguments

From the invocation arguments, extract:

• Video reference (positional): an absolute path to a local video file, or a

  YouTube URL / 11-char video ID.

• -seq / --sequence N: capture one frame every N seconds. Default: 2.

  Must be an integer >= 1. Maps to the script's --interval=N.

• Remaining free text: the user's analysis question (e.g. "when drag ends,