From 3c57aebe23204affdfe2c1a9e6abcea3cd13e43b Mon Sep 17 00:00:00 2001 From: Ben McAdams Date: Mon, 13 Jul 2026 08:55:01 -0700 Subject: [PATCH 1/3] Add .codex-plugin/plugin.json for SDK MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mirrors the Claude Code plugin manifest with the fields OpenAI Codex additionally requires: version, skills path, and the full interface block (displayName, short/longDescription, developerName, category, capabilities, website/privacy/tos URLs, defaultPrompt, brandColor). Skills-only shape — no MCP, no app — matches the CLI-wrapper precedent set by Stripe, Netlify, Vercel, and Supabase in openai/plugins. --- .codex-plugin/plugin.json | 41 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 .codex-plugin/plugin.json diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json new file mode 100644 index 0000000..7406730 --- /dev/null +++ b/.codex-plugin/plugin.json @@ -0,0 +1,41 @@ +{ + "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": "#FF4A00" + } +} From 3db5618c849985074188dcdd0bd94b4614aaea95 Mon Sep 17 00:00:00 2001 From: Ben McAdams Date: Mon, 13 Jul 2026 08:59:19 -0700 Subject: [PATCH 2/3] Wire up Zapier brand logo and fix brand color MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Copies logo.svg and icon.svg from zapier/zapier-mcp (single source of truth for the Zapier plugin logo across our marketplace surfaces). Adds them to the Codex interface block via logo + composerIcon. Also corrects brandColor #FF4A00 → #FF4F00 to match the actual hex used in the shared SVG assets. --- .codex-plugin/plugin.json | 4 +++- assets/icon.svg | 11 +++++++++++ assets/logo.svg | 11 +++++++++++ 3 files changed, 25 insertions(+), 1 deletion(-) create mode 100644 assets/icon.svg create mode 100644 assets/logo.svg diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 7406730..1f4a4a6 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -36,6 +36,8 @@ "Send an email through Gmail using the Zapier SDK", "Look up a Google Sheets row with the Zapier SDK" ], - "brandColor": "#FF4A00" + "brandColor": "#FF4F00", + "logo": "./assets/logo.svg", + "composerIcon": "./assets/icon.svg" } } 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 @@ + + + + + + + + + + + From e72fd4f98e1d27f7f9017c9b3b136361f840daff Mon Sep 17 00:00:00 2001 From: Ben McAdams Date: Mon, 13 Jul 2026 09:02:52 -0700 Subject: [PATCH 3/3] Add Codex install section to README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Codex now has native plugin support via .codex-plugin/plugin.json — surface the install commands next to the existing Claude Code ones, and drop Codex from the 'clone-and-reference' fallback since it's no longer needed there. CLI syntax verified against openai/codex#21396. --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) 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.):