cleya harvest
Promote an approved scene to a reusable starter (the harvest loop) — INSTRUMENT-GATED: probe frames are rendered and measured; alignment defects block (fix or --force), contrast findings warn. De-brands concrete colors back to $palette.* tokens (pass --brand), auto-detects copy slots + a beat map, validates, and files it in your user library (~/.cleya/starters) — where starters and draft pick it up alongside the shipped set. Every good bespoke job raises the floor for every future instant draft.
cleya harvest --scene clips/scenes/promo.json --brand brand.json --name book-flip-promo --when 'Book-brand promo with flipping titles'
Options
| Flag | What it does | |
|---|---|---|
--scene | The approved scene — file path or inline JSON | required · string |
--name | Kebab-case starter name (unique) | required · string |
--when | One sentence: when to reach for this starter | required · string |
--brand | The brand it was built with — enables de-branding to $palette tokens | string |
--overwrite | Replace an existing user starter of the same name | boolean |
--force | Skip the instrument gate (alignment defects would then enter the library — use sparingly) | boolean |
Category: edit — transform existing media
Generated from the toolkit
Generated from cleya capabilities, the toolkit's own manifest, so it cannot drift.
Run cleya harvest --help for the same information in your terminal.