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.
@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 addto 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.