HyperFrames CLI

Run commands as npx hyperframes ... unless project instructions provide a wrapper. Obey the wrapper when present. The CLI requires Node.js 22 or newer and FFmpeg.

Development loop

1. Scaffold: npx hyperframes init <project> or capture a site. In non-TTY mode, pass --non-interactive --example=<name>.
2. Author: write the composition using /hyperframes-core.
3. Get fast feedback while editing: run npx hyperframes lint after the first HTML pass and after structural changes.
4. Run the final gate: run npx hyperframes check; it reruns lint before opening the browser. Do not prepend a redundant standalone lint invocation. Add --snapshots for annotated overview frames and finding crops.
5. Inspect sub-compositions: when index.html mounts data-composition-src, capture midpoint snapshots and inspect each mounted scene.
6. Open the final Studio preview: run npx hyperframes preview, hand the timeline project URL to the user, and ask whether to revise or render.
7. Render only after approval: use draft quality for iteration and high quality for delivery.
8. Verify the output: confirm the file exists, is non-empty, and has a plausible duration.

# Fast iteration check; repeat while authoring as needed.
npx hyperframes lint