hyperframes-cli

CLI toolkit for scaffolding, validating, previewing, and rendering HyperFrames video compositions.

- Scaffolds projects with init (9 templates available), lints compositions for structural errors, and visually inspects layouts for text overflow and clipping issues across the timeline

- Preview mode hot-reloads on file changes; render supports quality tiers (draft/standard/high), multiple formats (MP4/WebM), frame rates, and parametrized variable overrides

- Includes environment troubleshooting commands (doctor, browser, info) and requires Node.js >= 22 and FFmpeg

- For audio preprocessing (TTS, transcription, background removal), use the hyperframes-media skill instead

HyperFrames CLI

Everything runs through npx hyperframes. Requires Node.js >= 22 and FFmpeg.

Workflow

- Scaffold - npx hyperframes init my-video

- Write - author HTML composition (see the hyperframes skill)

- Lint - npx hyperframes lint

- Visual inspect - npx hyperframes inspect

- Preview - npx hyperframes preview

- Render - npx hyperframes render

Lint and inspect before preview. lint catches missing data-composition-id, overlapping tracks, and unregistered timelines. inspect opens the rendered composition in headless Chrome, seeks through the timeline, and reports text spilling out of bubbles/containers or off the canvas.

Scaffolding