Files
hyperframes/packages/codex-plugin
James d04e02ddd0 refactor(codex-plugin): portable drift check + lefthook cycle guard
Review findings from /simplify:

- Replace execSync('diff -r') with in-process tree compare. Removes the
  POSIX diff dependency, eliminates the temp-dir dance, and yields a
  structured drift list (changed/missing/extra per path) instead of a
  2000-char-truncated blob.
- Use fileURLToPath for __dirname so paths work on Windows.
- Replace existsSync+statSync TOCTOU with a single statSync in try/catch,
  and fix the error message for the non-directory case.
- Switch readdirSync to { withFileTypes: true } to avoid per-entry
  statSync when scanning for extras.
- lefthook: exclude packages/codex-plugin/skills/** from the
  codex-plugin-sync glob. Without this, editing the built copy (e.g.
  during a conflict resolution) would trigger the hook to rebuild and
  overwrite the user's edit.
2026-04-21 19:23:47 +00:00
..

@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.heygen.com/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.