HyperFrames CLI

HyperFrames CLI guides a project from scaffolding through inspection, timeline editing, preview, and rendering. It uses the project's wrapper when available, otherwise the HyperFrames command-line tool. Node.js 22+ and FFmpeg are required, with a compatible CLI and any additional dependencies needed by the selected workflow. The skill retains an Apache-2.0 license.

The command groups cover blank project initialization, URL capture, project information, compositions, timeline inspection, documentation, reusable registry content, media treatment, sound, presentation, and local or hosted rendering. Timeline edits use the same operations as Studio so the result stays in Studio's shape.

Use it to build or modify a HyperFrames project, inspect visible output, or produce a verified render through a local or explicitly authorized hosted workflow. A successful check alone is not a reason to render. The normal sequence reaches an answering preview URL and lets the user review it, unless the request already asks for a file or uninterrupted work.

Keep the installed or explicitly selected version rather than automatically upgrading a working pin. Dependency downloads need review. Default helper invocations disable telemetry, skill updates, and update checks through the three HyperFrames environment controls. Analytics can link account details to PostHog. Feedback messages, provider uploads, paid generation, publishing, cloud deployment, and voice or avatar recreation require authorization covering the action and payer. Source footage, likeness, and cloned voices also require appropriate rights and consent.

Inputs include the project, compositions, media, timeline references, and requested changes. Outputs include inspection results, snapshots, a preview, edit receipts, or rendered video. Lint runs after the first writing pass and structural changes. The next gate is:

npx hyperframes check --json

Fix every error before trusting the result: layout and contrast audits do not run while lint errors remain, and zero samples provide no evidence. Contrast findings include a suggested color. A single entrance sample can be informational, while a video of at least three seconds without visible change fails the static-motion check.

Read snapshot PNGs to inspect the video and capture each scene's midpoint when sub-compositions are present. Missing hero content or tiny unstyled content indicates a mount defect. For final files, verify a non-empty render, compare its probed duration with the root duration, and inspect decoded frames. Draft, looks, and delivery quality settings support different stages of iteration.

Timeline inspection returns absolute start and end times, owning files, and clip references. Planned edits can be previewed before execution. Overlapping clips require explicit overwrite or moving the neighbor; clips extending beyond a composition require increasing its root duration first. Commands do not change that duration automatically. Batch plans produce receipts that support undo. Project history also provides begin, inspect, undo, and end operations for preserving and building on user edits.

Rendering options include local execution, a strict Docker container, variable-driven batches, hosted cloud rendering, AWS Lambda, and GCP Cloud Run. Desktop commands open the app or catch up with it; preview context can retrieve the current selection. A missing selection calls for the user to select the element.

For missing Chrome, use the browser setup workflow and inspect the diagnostic result's success field rather than its exit status alone. Heavy pages may need longer check or snapshot timeouts. Keep proxy handling for unusual codecs. Failed captures and partial files cannot be treated as successful input; retries use a new output folder. Preview cleanup before execution and preserve the history directory. Long renders can detach with a log, while short ones stay in the foreground. Deprecated validation aliases and script telemetry commands are excluded from the workflow. Plugin installation follows the pinned plugin rules when applicable.