hyperframes-cli
Installation
Summary
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-mediaskill instead
SKILL.md
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
hyperframesskill) - 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.