Before you begin

  • Codex already working with a local project folder.
  • Node.js 22 or newer, npm, and FFmpeg available for local rendering.
  • Permission to install skills on your computer if you choose the standalone route.

These instructions follow the linked official documentation. They are not a claim of testing every operating system or agent version. Check your installed version if the interface differs.

1. Check whether you already have the plugin

HyperFrames supports Codex, but Claude's marketplace commands are specific to Claude Code. The current HyperFrames plugin guide tells Codex users to use their existing HyperFrames plugin and notes that directory updates are published separately.

If HyperFrames by HeyGen is already available in your Codex setup, use its bundled skills and tools. Ask Codex which installation it can see. If there is no installed plugin, the standalone route below gives you a documented starting point.

Prompt · check the current setup
Check whether the official HyperFrames by HeyGen plugin or standalone HyperFrames skills are available in this chat. Tell me which you can use. If a plugin is installed, use its bundled skills and launcher for this project.

2. Install standalone skills when needed

For an installation run by you or an agent without an interactive picker, HyperFrames documents the command below. It installs or refreshes the core skills and existing HyperFrames workflows in the global skills store. It is not confined to the current video folder.

If you prefer an interactive installer, run npx skills add heygen-com/hyperframes and select Core Skills. After either route, start a fresh Codex chat with your video folder open. Skip this step when using an existing plugin.

Terminal · standalone installation
npx hyperframes skills update

3. Make the input specific enough to review

Choose one small communication task. The example below explains a fictional three-step workflow, so you can judge the sequencing without needing stock footage, a website capture, or narration. Its wording is a sample, not a claim about a real product.

For standalone skills, ask Codex to use /hyperframes. If you chose the plugin route, invoke the installed HyperFrames skill instead and keep the rest of the brief. Request the plan first so you can correct the story before the agent builds it.

Prompt · first Codex video
Using /hyperframes, make a 12-second silent video in this folder.

Explain this sample workflow: Collect → Organize → Share.
Canvas: 1920 × 1080, 30 fps.
Use three simple cards, generous spacing, dark text on a light background, and a blue accent.
Introduce one card at a time, then show all three together for the final 3 seconds.
Use only the three labels above; do not invent statistics or product claims.

Show me the sequence before building. After I approve it, create the editable HyperFrames project, run the appropriate checks, and open a local preview. Tell me where the project is saved.

4. Review the result in the same project

Keep revisions in the same conversation and project folder. Watch once without stopping to judge whether the story makes sense; watch again to look for layout and timing problems. This avoids spending the first revision on a tiny detail while the sequence still needs work.

Use the element's visible text and a timestamp to identify it. If you provide an image of the problem, describe the desired result too; the image alone does not tell Codex which change matters.

Prompt · make a targeted change
At 6 seconds, the "Share" card competes with the previous card. Keep all three labels, but stagger the entrances so only one card is moving at a time. Preserve the final 3-second overview. Check the updated project and show the preview again.

5. Export through the route you installed

With a plugin, ask Codex to check and render using the bundled launcher. With standalone skills, you can ask Codex to run the commands below, or run them yourself from the folder containing the composition.

The commands perform structural validation, browser checks, and an MP4 render. Inspect the reported output and then play the MP4 yourself. Save the project source alongside the export so another revision remains straightforward.

Terminal · standalone project export
npx hyperframes lint
npx hyperframes check
npx hyperframes render --output workflow.mp4

If Codex cannot find HyperFrames

For standalone skills, begin with a new Codex session and a freshness check. If it reports missing or outdated core skills, rerun the standalone update. A freshness check helps inspect the installation; you should also confirm that the new chat actually discovers the skill.

For a plugin, inspect and update the plugin through your Codex setup instead. If the skill is available but the video fails, give Codex the full error and ask it to inspect the project folder and local prerequisites.

Terminal · standalone skill check
npx hyperframes skills check
  • Do not copy a Claude Code plugin-install command and rename its executable to codex.
  • Avoid manually duplicating the same skills across several folders; first inspect what Codex already loads.
  • When reporting a failure, include the command, the error, and whether preview or export is affected.

Prefer directing on a canvas?

The HyperFrames Studio desktop app can also connect to a locally installed Codex agent. That is a separate entry point from running Codex in a project folder. Follow the Studio app's agent-connection instructions for that setup; this guide covers the local Codex project workflow.

Official sources

HyperFrames evolves quickly. Use these references for current commands and details.

KEEP LEARNING

Make your first HyperFrames video

Something unclear? Tell us where you got stuck.