mirror of https://github.com/heygen-com/hyperframes.git synced 2026-11-14 13:27:13 +00:00

Files

T

James 2dd7da562a feat(codex-plugin): add @hyperframes/codex-plugin package

Bundles the 5 hyperframes skills (hyperframes, hyperframes-cli,
hyperframes-registry, gsap, website-to-hyperframes) as an OpenAI Codex
plugin per developers.openai.com/codex/plugins/build.

Users can install directly:
  codex plugin marketplace add heygen-com/hyperframes --sparse packages/codex-plugin

The skills/ directory under packages/codex-plugin/ is a built copy of
the repo-root skills/. A lefthook pre-commit hook auto-rebuilds when
any skill file changes, and `bun run lint` runs a drift check so CI
fails if the committed plugin copy diverges.

2026-04-21 19:11:14 +00:00

2.0 KiB

Raw Blame History

@hyperframes/codex-plugin

OpenAI Codex plugin that bundles the HyperFrames skills for AI-assisted video authoring.

Install (direct from this repo)

codex plugin marketplace add heygen-com/hyperframes --sparse packages/codex-plugin

Then enable the hyperframes plugin in Codex.

Requirements

The skills invoke the hyperframes CLI via npx hyperframes, which needs:

Node.js >= 22
FFmpeg on PATH

See hyperframes.dev/quickstart for full setup.

What's inside

Five skills, source-of-truth in skills/ at the repo root, copied verbatim by build.mts:

hyperframes — composition authoring (HTML + GSAP + CSS), house style, visual styles, palettes
hyperframes-cli — hyperframes init / lint / preview / render / transcribe / tts / doctor
hyperframes-registry — hyperframes add to install registry blocks and components
gsap — GSAP tween/timeline/performance reference
website-to-hyperframes — 7-step pipeline turning any URL into a video

Structure

packages/codex-plugin/
  .codex-plugin/plugin.json    # Codex manifest
  assets/                      # icon + logo (PNGs)
  skills/                      # built output — DO NOT edit directly
  build.mts                    # copies ../../skills/<name>/ → ./skills/<name>/

Editing skills

Edit the source in skills/ at the repo root. Run the build to refresh the plugin copy:

bun run --cwd packages/codex-plugin build

CI runs bun run --cwd packages/codex-plugin check on every PR to fail if skills/ here has drifted from the sources.

Publishing

The plugin ships in the main HyperFrames release. To submit to OpenAI's plugin directory, we fork openai/plugins, copy the contents of this package into plugins/hyperframes/, append an entry to .agents/plugins/marketplace.json, and open a PR.

2.0 KiB Raw Blame History