Terminal interface

Scriptable context packs from the command line.

The CLI is for local jobs, batch processing, shell pipelines, and runs where stdout needs to stay machine-readable.

Basic run

The default command writes a job folder under .yt2ctx and prints the requested artifact text to stdout.

npm run cli -- "https://www.youtube.com/watch?v=VIDEO_ID"

Useful options

Tune output mode, selected frame count, candidate sampling, and output directory.

npm run cli -- "<url>" \
  --output .yt2ctx \
  --top-k 10 \
  --selection-mode density \
  --mode style \
  --candidate-interval 6 \
  --max-candidates 48 \
  --frame-width 768

Why it exists

The CLI keeps progress on stderr and artifacts on stdout, which makes it safe to pipe into other tools.

It is the right interface for repeatable local work, longer videos, and automation that should not depend on a web session.