diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 000000000..183f278f6
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,43 @@
+{
+  "name": "hyperframes",
+  "version": "0.1.0",
+  "description": "Write HTML, render video. Compositions, GSAP animations, captions, voiceovers, audio-reactive visuals, and website-to-video capture for HyperFrames.",
+  "author": {
+    "name": "HeyGen",
+    "email": "hyperframes@heygen.com",
+    "url": "https://hyperframes.heygen.com"
+  },
+  "homepage": "https://hyperframes.heygen.com",
+  "repository": "https://github.com/heygen-com/hyperframes",
+  "license": "Apache-2.0",
+  "keywords": [
+    "hyperframes",
+    "video",
+    "html",
+    "gsap",
+    "animation",
+    "composition",
+    "rendering",
+    "captions",
+    "tts",
+    "audio-reactive"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "HyperFrames",
+    "shortDescription": "Write HTML, render video",
+    "longDescription": "Build videos from HTML with HyperFrames. Author compositions with HTML + CSS + GSAP, use the CLI for init/preview/render/transcribe/tts, install reusable registry blocks and components, follow the GSAP animation reference, and turn any website into a video with the 7-step capture-to-video pipeline.",
+    "developerName": "HeyGen",
+    "category": "Design",
+    "capabilities": ["Read", "Write"],
+    "websiteURL": "https://hyperframes.heygen.com",
+    "defaultPrompt": [
+      "Turn this website into a 20-second product promo",
+      "Create an animated title card with kinetic type",
+      "Add synced captions to this voiceover"
+    ],
+    "brandColor": "#0a0a0a",
+    "composerIcon": "./assets/icon.png",
+    "logo": "./assets/logo.png"
+  }
+}
diff --git a/README.md b/README.md
index b25001e62..e808907a6 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,12 @@ npx skills add heygen-com/hyperframes
 
 This teaches your agent (Claude Code, Cursor, Gemini CLI, Codex) how to write correct compositions and GSAP animations. In Claude Code, the skills register as slash commands — invoke `/hyperframes` to author compositions, `/hyperframes-cli` for CLI commands, and `/gsap` for animation help.
 
+For Codex specifically, the same skills are also exposed as an [OpenAI Codex plugin](./.codex-plugin/plugin.json) — sparse-install just the plugin surface:
+
+```bash
+codex plugin marketplace add heygen-com/hyperframes --sparse .codex-plugin --sparse skills --sparse assets
+```
+
 #### Try it: example prompts
 
 Copy any of these into your agent to get started. The `/hyperframes` prefix loads the skill context explicitly so you get correct output the first time.
diff --git a/assets/icon.png b/assets/icon.png
new file mode 100644
index 000000000..05a8356a4
Binary files /dev/null and b/assets/icon.png differ
diff --git a/assets/logo.png b/assets/logo.png
new file mode 100644
index 000000000..3dceea068
Binary files /dev/null and b/assets/logo.png differ
diff --git a/bun.lock b/bun.lock
index db108df88..6f9b39a0e 100644
--- a/bun.lock
+++ b/bun.lock
@@ -21,7 +21,7 @@
     },
     "packages/cli": {
       "name": "@hyperframes/cli",
-      "version": "0.4.5",
+      "version": "0.4.11",
       "bin": {
         "hyperframes": "./dist/cli.js",
       },
@@ -62,7 +62,7 @@
     },
     "packages/core": {
       "name": "@hyperframes/core",
-      "version": "0.4.5",
+      "version": "0.4.11",
       "dependencies": {
         "@chenglou/pretext": "^0.0.5",
       },
@@ -88,7 +88,7 @@
     },
     "packages/engine": {
       "name": "@hyperframes/engine",
-      "version": "0.4.5",
+      "version": "0.4.11",
       "dependencies": {
         "@hono/node-server": "^1.13.0",
         "@hyperframes/core": "workspace:^",
@@ -106,7 +106,7 @@
     },
     "packages/player": {
       "name": "@hyperframes/player",
-      "version": "0.4.5",
+      "version": "0.4.11",
       "devDependencies": {
         "tsup": "^8.0.0",
         "typescript": "^5.0.0",
@@ -115,7 +115,7 @@
     },
     "packages/producer": {
       "name": "@hyperframes/producer",
-      "version": "0.4.5",
+      "version": "0.4.11",
       "dependencies": {
         "@fontsource/archivo-black": "^5.2.8",
         "@fontsource/eb-garamond": "^5.2.7",
@@ -154,7 +154,7 @@
     },
     "packages/shader-transitions": {
       "name": "@hyperframes/shader-transitions",
-      "version": "0.4.5",
+      "version": "0.4.11",
       "dependencies": {
         "html2canvas": "^1.4.1",
       },
@@ -166,7 +166,7 @@
     },
     "packages/studio": {
       "name": "@hyperframes/studio",
-      "version": "0.4.5",
+      "version": "0.4.11",
       "dependencies": {
         "@codemirror/autocomplete": "^6.20.1",
         "@codemirror/commands": "^6.10.3",