Shotrunner
Showcase
DOCS/OPERATIONS & PUBLISHING/CLI Reference

CLI Reference

Complete command matrix and syntax for all 16 shorts CLI subcommands.

All pipeline tasks are accessible via the shorts CLI. Commands validate inputs and record PASS markers to the series log.

Command Reference Table

COMMANDSTAGEARGSACTION
licenseSetupactivate --key <k> | status | fingerprintActivate and inspect your license
check-envSetup—Self-check dependencies & system hardware
statusAll--series <s>Print series progress matrix
series00--name <slug> [--force]Scaffold series folder & config
verify-raw01--raw <raw.md>Validate research citations
verify-script02--script <final.md> --raw <raw.md>Enforce word count & phonemes
track-topic02--script <final.md> --log <used.md>Append topic to deduplication log
tts03--script <final.md>Synthesize voice narration WAV
subtitles04--audio <wav> --script <final.md>Whisper transcription + spell fix
verify-demand05--needs <needs.md>Validate visual planning demand
download06--needs <needs.md> [--source list]Scrape, OCR filter & re-encode
verify-sort07--images <images/>Audit sorted library naming & tags
lint08--plan <plan.yaml>Validate shot plan & cue sync
render08--config <plan.yaml> [--debug-frame t]Build 1080x1920 or 1920x1080 MP4 with Ken Burns
qc08--video <mp4> --plan <plan.yaml>Post-render sync & -14 LUFS checks
upload09--video <mp4> --plan <plan.yaml>Publish to YouTube via OAuth

Key Command Examples

Common Operations
1# Check series status matrix
2shorts status --series my-series
3
4# Validate a draft script (checks word count & phonemes)
5shorts verify-script --script series/my-series/scripts/001_slug/final.md --raw series/my-series/scripts/001_slug/raw.md
6
7# Generate TTS voiceover
8shorts tts --script series/my-series/scripts/001_slug/final.md

Rendering and QC Flags

Render & Quality Control
1# Render single debug frame at timestamp 2.5s for fast inspection
2shorts render --config series/my-series/scripts/001_slug/plan.yaml --debug-frame 2.5
3
4# Full video render
5shorts render --config series/my-series/scripts/001_slug/plan.yaml
6
7# Auto-fix audio loudness to -14.0 LUFS
8shorts qc --video series/my-series/scripts/001_slug/short.mp4 --plan series/my-series/scripts/001_slug/plan.yaml --loudfix
Was this "CLI Reference" page helpful?
PREVIOUS
Audio Mastering & -14 LUFS
Voice synthesis, BGM sidechain ducking, SFX placement, and broadcast loudness.
NEXT
Autonomous Agent Guide
Driving the engine with Claude Code, Antigravity, or Cursor using AGENTS.md.
© 2026 SHOTRUNNERLOCAL-FIRST · AGENT-DRIVEN