# Hyperframes CLI

HyperFrames CLI dev loop.

- Repository: https://github.com/calesthio/OpenMontage (74341 stars)
- Category: DevOps
- License: AGPL-3.0
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add calesthio/OpenMontage --skill hyperframes-cli -g -a claude-code -y`
Codex: `npx skills add calesthio/OpenMontage --skill hyperframes-cli -g -a codex -y`
Cursor: `npx skills add calesthio/OpenMontage --skill hyperframes-cli -g -a cursor -y`
Gemini CLI: `npx skills add calesthio/OpenMontage --skill hyperframes-cli -g -a gemini-cli -y`

## Description

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# HyperFrames CLI

Everything runs through `npx hyperframes` unless project instructions specify a local wrapper. Obey the local wrapper exactly. Requires Node.js >= 22 and FFmpeg.

## Workflow

1. **Scaffold**, `npx hyperframes init my-video` (or `capture` from a URL). `init` also checks the installed skills against the latest on GitHub and updates the global set if any are out of date. The `--skip-skills` flag is currently neutered (temporary, while the skills.sh registry catches up), so every `init` runs this check and pulls our latest skills regardless.
2. **Write**, author HTML composition (see the `hyperframes-core` skill)
3. **Lint**, `npx hyperframes lint`
4. **Validate**, `npx hyperframes validate` (runtime errors + contrast)
5. **Visual inspect**, `npx hyperframes inspect`
6. **Preview**, `npx hyperframes preview` opens **Studio**, the timeline editor where the user can manually edit anything (not just watch). Review there, then ask before rendering.
7. **Render**, pick the variant:
   - Iterate: `npx hyperframes render --quality draft`
   - Deliver: `npx hyperframes render --quality high --output out.mp4`
   - CI / cross-host repro: `npx hyperframes render --docker --strict --output out.mp4`
   - Cloud (long / large): `npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait` (see Lambda below)

Run lint, validate, and inspect before preview. `lint` catches missing `data-composition-id`, overlapping tracks, and unregistered timelines. `validate` loads the composition in headless Chrome and reports runtime console errors plus WCAG contrast issues. `inspect` seeks through the timeline and reports text spilling out of bubbles/containers or off the canvas, and, when a `*.motion.json` sidecar is present, verifies motion intent (entrances firing under seek, stagger order, in-frame, liveness) against that same seeked timeline.

The rest: https://github.com/calesthio/OpenMontage/blob/HEAD/.agents/skills/hyperframes-cli/SKILL.md