Before you start
- Cursor, signed in. Agent usage bills to your Cursor plan.
- Node.js 22 or newer, and npm.
- FFmpeg, for rendering MP4 files. Run
npx hyperframes doctorto check.
Install
- Project skills
- For your user
- Plugin
Run the command above in the project folder. The skills stay with that
project. Reload Cursor or start a new agent chat afterwards.
Ask for your first video
Open a new agent chat in an empty project and paste:What happens
- The agent reads the HyperFrames guide for your kind of video, such as a product launch or an explainer, and builds the project in your folder. For a longer film that tells a story, it first offers three storylines to pick from.
- It checks the project and opens a local preview.
Preview and render
To reopen the preview later, run this in Cursor’s terminal, inside the project folder:Prefer an app?
The HyperFrames Studio app for Mac and Linux gives you a chat, a preview, and an editor in one window. It runs Claude Code, Codex, and other agents, but not Cursor. See Connect your agent.If something goes wrong
- The agent does not see the skill. Start a new agent chat. Confirm that
.agents/skills(project install) or~/.cursor/skills(user install) containshyperframes, then runnpx hyperframes skills check. - The render fails. Run
npx hyperframes doctorand fix what it reports. - Anything else. See Troubleshooting.