CLI
Every bin/vawe verb and its flags.
One command runs everything: bin/vawe. bin/vawe --help lists the verbs. bin/vawe <verb> --help lists the flags. A wrong flag exits 2 and prints the valid ones.
| Verb | What it does |
|---|---|
new | start a film: films/<name>/page.html and brief.md |
dev | draft render: half size, 30 fps, silent, plus a key-frame sheet PNG |
ship | final render: 60 fps, motion blur, audio mixed, then a final check and a fresh judge. Runs in the background |
critique | phone sheet, strip, loop seam, measured deltas and page-check |
compare | reference and your film at the same exact seconds, side by side, one PNG |
coverage | SSIM of your render against the reference at every step |
review | one report, one sheet: clipped glyphs, text timing, motion, coverage |
spec | measure a reference mp4 into SPEC.md and spec.json |
studio | live scrubbable preview. It edits the page literals in place |
check | run one gate by name. Bare check lists the gates |
doctor | check Node, ffmpeg, Chrome and the other tools, and print the install line for each missing one |
moves | render the stale clips in prompts/moves/ |
e2e | page tests plus a parallel half-size draft of every film |
test | run every tests/**/*.test.mjs with node --test |
judge | prepare key frames and the rubric for a fresh session to score |
The flags you use most
bin/vawe new my-film --from prompts/story-explainer.md --length 30 --aspect 16:9 --title "..."
bin/vawe dev films/my-film/page.html --from 2 --to 6 --aspect 9:16 --audio
bin/vawe ship films/my-film/page.html --aspect all
bin/vawe ship --status --wait
bin/vawe compare --page films/my-film/page.html --at 2.5,3.1,4
bin/vawe studio films/my-film/page.html --port 8800new --ref <mp4>recreates a reference. It writesfilms/recreations/<name>withSPEC.md.dev --out <path>sets the output file. The default isout/<name>-draft.mp4.ship --out <path>sets the output file. The default isout/<name>.mp4. It does not combine with--aspect all.ship --waitblocks until the render ends.ship --statusprints the progress or the result, and with--waitit waits at most 100 s.critique --ref <mp4>measures against a reference. With--final, a pass unlocksship.judge --freshscores now with a separate headless session. It advises and never blocks.
The loop, end to end
bin/vawe new my-film --from prompts/<template>.md # brief and starter page
bin/vawe dev films/my-film/page.html # draft
bin/vawe critique films/my-film/page.html # in a fresh session
bin/vawe dev films/my-film/page.html --from 2 --to 4 # fix only the named seconds
bin/vawe ship films/my-film/page.html # finalSee Quality gates for check, and Reading your film for the views.