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 (spec 0031). It is PAID (VO per card + music + cards). It prints a plan first — the stages it will run, the generation count, and an estimated spend (~USD X.XX + N,NNN VO characters, a best-effort cue from the same price model the studio uses). It prompts [y/N] only when the estimate crosses the spend cap spend.confirm_above (currency for images+music, characters for VO); below the cap it just runs (the printed estimate is the disclosure). --dry-run prints the plan + estimate and stops; --yes skips the prompt (CI/unattended). Configure the caps — global or per-project:

Config key	Caps	Default
`spend.confirm_above.amount`	image + music + social, in the configured currency	`10`
`spend.confirm_above.characters`	voice narration (character-billed)	`50000`

Set either to 0 to disable that axis. The studio enforces the same caps per generation request (a 412/confirm gate). - 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¶

Flag	Effect
`-w, --workspace <slug>`	the reel workspace (required)
`--takes <N>`	candidate takes per stage (default 1 → auto-pick)
`--theme <kw>`	theme for cards / cover / VO / music (an unknown theme is a hard error)
`--avatar <name>`	render overlay cards from an avatar (image-to-image)
`--cover <scene>`	also generate a themed cover from this scene
`--silent`	text-only timing — skip VO + music; build a silent reel
`--no-music`	skip the music bed (keep VO)
`--dry-run`	print the plan + generation estimate; generate nothing
`--yes`	skip the spend confirmation

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