diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 0000000..1f4a4a6
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,43 @@
+{
+ "name": "sdk",
+ "version": "0.1.0",
+ "description": "Agent skills and verified examples for writing Zapier SDK code that works.",
+ "author": {
+ "name": "Zapier",
+ "email": "support@zapier.com",
+ "url": "https://zapier.com"
+ },
+ "homepage": "https://docs.zapier.com/sdk",
+ "repository": "https://github.com/zapier/sdk",
+ "license": "MIT",
+ "keywords": [
+ "zapier",
+ "sdk",
+ "agent",
+ "ai-agent",
+ "mcp",
+ "automation",
+ "integration",
+ "typescript"
+ ],
+ "skills": "./skills/",
+ "interface": {
+ "displayName": "Zapier SDK",
+ "shortDescription": "Programmatic access to Zapier's 9,000+ apps via the TypeScript SDK.",
+ "longDescription": "Let your agent connect to anything. Zapier handles the keys. Ships the zapier-sdk skill, the zapier-sdk-explorer subagent, and a verified examples corpus so your code uses real action keys the first time.",
+ "developerName": "Zapier",
+ "category": "Developer Tools",
+ "capabilities": [],
+ "websiteURL": "https://docs.zapier.com/sdk",
+ "privacyPolicyURL": "https://zapier.com/privacy",
+ "termsOfServiceURL": "https://zapier.com/tos",
+ "defaultPrompt": [
+ "Connect Notion via Zapier and search my pages",
+ "Send an email through Gmail using the Zapier SDK",
+ "Look up a Google Sheets row with the Zapier SDK"
+ ],
+ "brandColor": "#FF4F00",
+ "logo": "./assets/logo.svg",
+ "composerIcon": "./assets/icon.svg"
+ }
+}
diff --git a/README.md b/README.md
index 0c40514..c32d772 100644
--- a/README.md
+++ b/README.md
@@ -89,7 +89,16 @@ Result: fewer round trips to the docs, no more invented action keys, and workflo
/plugin install sdk@zapier
```
-### Cursor, Codex, Copilot, and other assistants
+### OpenAI Codex
+
+```
+codex plugin marketplace add zapier/marketplace
+codex plugin add sdk@zapier
+```
+
+Or open the in-CLI picker with `/plugins` and toggle the SDK plugin on.
+
+### Cursor, Copilot, and other assistants
The [skill](./skills/zapier-sdk/) conforms to [agentskills.io](https://agentskills.io) so any conformant runtime can load it directly. For tools without native agentskills.io support, clone the repo and reference `skills/zapier-sdk/SKILL.md` from your assistant's rules or instructions file (`.cursorrules`, `AGENTS.md`, `.github/copilot-instructions.md`, etc.):
diff --git a/assets/icon.svg b/assets/icon.svg
new file mode 100644
index 0000000..b370449
--- /dev/null
+++ b/assets/icon.svg
@@ -0,0 +1,11 @@
+
diff --git a/assets/logo.svg b/assets/logo.svg
new file mode 100644
index 0000000..b370449
--- /dev/null
+++ b/assets/logo.svg
@@ -0,0 +1,11 @@
+