hyperframes-cli

github:heygen-com/hyperframes · first seen 2026-10-30 · installs 1.3M · source · badge

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

Works with

Used with

Skill Health 90 (freshness and quality) estimated by backskills

Listed, not yet scored. This skill has no public model test yet. It is in the scoring queue; submitted skills go first, then the most-installed.

Freshness 100 · Quality 80 · Efficacy not yet tested

Version history

Diff at 2026-11-01T09:00:33+00:00

--- previous
+++ current
@@ -32,7 +32,7 @@
 2. `npx hyperframes check --json` and fix every error. While a lint error remains the layout and contrast audits don't run; "0 samples" means nothing was checked. Contrast failures carry a `suggestedColor`. A finding at a single sample (an entrance in flight) is info; a 3 s+ video with no visible change fails `sweep_static`.
 3. `npx hyperframes snapshot` and read the PNGs (under `.hyperframes/artifacts/snapshots/`): that is how you see the video. With sub-compositions, snapshot a midpoint of every scene; tiny unstyled content or a missing hero is a mount defect (`../hyperframes/references/format.md`).
 4. `npx hyperframes preview --background`, check the URL answers 200, give the person the project URL and wait, unless they asked for the file or for no stops. Passing checks alone is not a reason to render.
-5. When it is time to render (step 4): `npx hyperframes render --quality looks --output out.mp4` (`draft` while iterating, `delivery` for the final). Confirm the file is non-empty and its `ffprobe` duration matches the root `data-duration`, then look at decoded frames.
+5. Time to render (step 4): `npx hyperframes render --quality looks -o out.mp4` (`draft` while iterating, `delivery` for the final; paid plan: `cloud render --fps <data-fps> --quality high -o out.mp4`). Confirm the file is non-empty and its `ffprobe` duration matches the root `data-duration`, then look at decoded frames.
 
 "This element" or the current selection: `npx hyperframes preview --context --json --context-fields selection`; `no-selection` means ask them to click it.
 
@@ -57,9 +57,9 @@
 
 | Need | Command |
 | --- | --- |
-| Local | `render --quality looks --output out.mp4` (`draft`, `delivery`) |
-| Reproducible container | `render --docker --strict --output out.mp4` |
-| Batch from variables | `render --batch rows.json --output "renders/{name}.mp4"` |
+| Local | `render --quality looks -o out.mp4` (`draft`, `delivery`) |
+| Reproducible container | `render --docker --strict -o out.mp4` |
+| Batch from variables | `render --batch rows.json -o "renders/{name}.mp4"` |
 | Hosted, no local Chrome or FFmpeg | `cloud render` (`references/cloud.md`) |
 | Your own AWS or GCP | `lambda render`, `cloudrun render` (`references/lambda.md`, `references/cloudrun.md`) |