# HyperFrames CLI — guide skill for tools & renderers

> **For AI agents:** find the right skill in one call — `curl -s "https://skills.varg.ai/api/search?q=<what the person wants>"` returns the matching use case and the best skills with install commands, as markdown (Russian works too). Full index: https://skills.varg.ai/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the use-case page.

Drive the HyperFrames CLI: scaffold, check, preview, snapshot, edit the timeline, render locally or in the cloud.

- **Type:** [Guide](https://skills.varg.ai/guides.md) · [Tools & renderers](https://skills.varg.ai/browse/skills/tooling.md)
- **Slug:** `hyperframes-cli`
- **Status:** live
- **Publisher:** HeyGen (vendor, verified)
- **License:** Apache-2.0
- **Source:** https://github.com/heygen-com/hyperframes/tree/main/skills/hyperframes-cli
- **Works in:** Claude Code, Codex, Cursor, Gemini CLI
- **Requires:** Node.js 22+, FFmpeg
- **Cost:** Free — local render; cloud renders run on your HeyGen, AWS or Google Cloud account
- **Adoption:** 1,300,000 installs, 73,064 GitHub stars (skills.sh, 2026-10-26)

## What it does

A job-by-job map of `npx hyperframes`: scaffolding, `check` with machine-readable fixes, frame snapshots and compares, timeline edits, preview, local and batch renders, cloud rendering (HeyGen, AWS Lambda, Google Cloud Run), publishing and project history. It explains how to read the CLI's JSON output and how to recover from build, browser and render failures with `doctor`.

## Use when

- Scaffolding a new HyperFrames project
- Checking, previewing or rendering a composition
- Rendering in the cloud or in batches
- Diagnosing a failed build or render

## Not for

- Writing the composition itself (use HyperFrames)

## Install

- Claude Code: `claude plugin marketplace add heygen-com/hyperframes && claude plugin install hyperframes@hyperframes`
- Codex: `npx skills add heygen-com/hyperframes --skill hyperframes-cli -a codex`
- Cursor: `npx skills add heygen-com/hyperframes --skill hyperframes-cli -a cursor`
- Gemini CLI: `npx skills add heygen-com/hyperframes --skill hyperframes-cli -a gemini-cli`

## Example output

https://skills.varg.ai/previews/hyperframes-cli.mp4 — Official docs demo: 'npx hyperframes render --output final.mp4' captures frames with 4 workers, finishes, and the rendered MP4 plays (credit: HeyGen (HyperFrames), https://hyperframes.heygen.com/guides/rendering)

## More tools & renderers skills

- [varg AI](https://skills.varg.ai/skills/varg-ai.md): The official varg skill: videos, images, speech and music through one API key, rendered in the cloud or locally.
- [Media Download](https://skills.varg.ai/skills/media-download.md): Save any video by link (X, YouTube, Instagram, TikTok, 1800+ sites) or Pinterest images as references, locally, no key.
- [Templates Gallery Ops](https://skills.varg.ai/skills/varg-templates-section.md): Internal runbook for the varg app Templates gallery: publish renders, preview clips, frame-0 posters, shelves.
- [HyperFrames Registry](https://skills.varg.ai/skills/hyperframes-registry.md): Pull any of ~450 ready-made blocks into a video as editable source: transitions, titles, captions, charts, 3D.
- [HyperFrames Media Use](https://skills.varg.ai/skills/hyperframes-media-use.md): Find or make every asset a video needs: music, SFX, voiceover, images, logos, avatars, transcripts, grades.
- [Remotion to HyperFrames](https://skills.varg.ai/skills/remotion-to-hyperframes.md): Port Remotion, Lottie, Three.js, p5 or canvas animations into HyperFrames and verify them frame by frame.