For AI agents: the documentation index is at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
CLI reference
Every vs command and the flags that matter across the pipeline.
--help on each command is the authority on flags. Generation is paid: run vs doctor before you spend, and use --dry-run when you want payloads and lint for free.
Commands
| Command | What it does |
|---|---|
vs init <dir> | Scaffold a film (shots.json, stills.json, README) |
vs doctor [task-id] | Check Node, .env, keys, ffmpeg, card tools |
vs stills <stills-file> | Generate reference stills into stills/ |
vs generate <shots-file> | Submit, poll, download clips to output/clips/<shot>/vNNN.mp4 |
vs score <prompt> | Lyria instrumental bed → score-vNNN.mp3 |
vs narrate <lines.tsv> | ElevenLabs per-line VO (NN\ttext TSV) |
vs narrate assemble <shots> | Place lines on the cut → narration.mp3 |
vs status [shots-or-task] | Show the manifest, or fetch one task |
vs use <shots> <shot> <version> | Select or roll back a clip revision |
vs download [shots-file] | Fetch succeeded clips not yet on disk |
vs animatic <shots-file> | Story reel from stills — $0 of video |
vs review <shots-file> | Frame contact sheet plus delivery flags |
vs stitch <shots-file> | Assemble clips and title cards |
vs upscale <shots-file> | Lanczos-upscale finals for delivery (free) |
vs share <video> | Two-pass compress under a size ceiling |
Cross-cutting flags
| Flag | Use |
|---|---|
--dry-run | Print payloads / lint; no network spend; no ffmpeg write |
--draft | 480p pass beside the final (namespaced outputs) |
--max-cost <usd> | Hard refusal if the estimate exceeds the ceiling |
Published with Edda