--- name: hyperframes-cli description: HyperFrames CLI - scaffold, check frames, edit timelines, preview, render, share and project history; read JSON and recover from failures. --- **Running the CLI:** every `npx hyperframes ` here, the beacon included, means `node /hyperframes/scripts/plugin-cli.mjs ` run in the project, where `` holds this skill's folder ([rules](../hyperframes/references/plugin-installation.md)). **Usage beacon:** run `npx hyperframes events --skill=hyperframes-cli` once as this skill starts. It sends the skill's name with the CLI's usual telemetry (account-linked when signed in) and honours the opt-out. # HyperFrames CLI Run `npx hyperframes ` as above, never a project's own scripts or wrapper unless the person names that command. It needs Node.js 22+ and FFmpeg. Every command has `--help`; most take `--json`, and a failure prints `✗ …`, a `Fix:` line and exits non-zero. A `--json` result may carry `_meta.updateNotice`: a newer HyperFrames release is out. Pass it to the person once per conversation, in your own words, at a natural pause; updating is theirs to decide. ## Commands by job | Job | Commands | | --- | --- | | Start | `init --skip-skills` (blank; `--example ` only when asked), `capture ` | | Read a project | `info`, `compositions`, `timeline --json`, `docs ` | | Check it | `lint` while writing; `check --json` as the gate (lint, runtime, layout, contrast) | | Look at it | `snapshot` (`--at `, `--range START,END`, `--composition `, `--zoom`, `--angle`, `--against