keryx reel make¶

Description¶

One command to take a reel from storyboard to finished mp4. For a workspace that already has a storyboard.json, reel make generates every missing artefact — VO per card, the music bed, an illustration for each overlay card (+ an optional cover) — auto-selects each, then runs reel build. It collapses the ~25-command stage-by-stage loop into one pass (spec 0020).

reel make is the "just make it" fast path. The per-stage voice/music/cards gen + pick commands remain the audition loop — generate several candidates and pick the best. make defaults to one take and auto-picks it.

Usage¶

keryx reel make --workspace <slug> [flags]

Behaviour¶

• Idempotent. A stage is skipped when its selection already exists (vo/NN.mp3, music.mp3, the card's media, cover.png) — so a re-run only generates what's still missing, and a failed/partial run is cheap to resume. Candidate takes in */takes/ alone don't count as done; only a selection does.
• Spend-aware. It is PAID (VO per card + music + cards). It prints a plan first — the stages it will run and the generation count — and asks [y/N] before spending. --dry-run prints the plan and stops; --yes skips the prompt (CI/unattended).
• Fail-fast + resumable. A stage error stops the run; the selections already made persist, so re-running picks up where it left off.
• Auto-pick = take 1. With --takes N>1 it still selects take 1 and notes that you can audition with the per-stage pick commands for a better choice.

Flags¶

Run keryx reel make --help for the authoritative, always-current flag set.

Example¶

keryx reel new my-post --bundle content/posts/my-post
keryx storyboard draft content/posts/my-post/index.md --workspace my-post  # draft + review
keryx reel make --workspace my-post --theme editorial                      # VO + music + cards + build