Add OpenAI Codex plugin manifest#17
Merged
Merged
Conversation
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.
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 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.
BenMcGit
marked this pull request as ready for review
July 13, 2026 16:04
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
.codex-plugin/plugin.jsonso this repo is installable as an OpenAI Codex plugin. Companion to the existing.claude-plugin/plugin.json(PR #7).What's in this PR
.codex-plugin/plugin.json— the plugin manifest.assets/{logo,icon}.svg— Zapier brand assets, sourced fromzapier/zapier-mcp/plugins/zapier/assets/so the same wordmark ships across every marketplace surface.README.md— new "OpenAI Codex" install section next to the existing Claude Code one; dropped Codex from the "clone-and-reference" fallback since it no longer needs it.Shape
Skills-only bundle — the same
./skills/directory the Claude Code plugin already exposes. No MCP server, no ChatGPT app. That matches the CLI-wrapper precedent set by Stripe, Netlify, Vercel, and Supabase inopenai/plugins.Fields shared with the Claude Code manifest (
name,description,author,homepage,repository,license,keywords) are duplicated verbatim so the two stay in sync. Codex-specific additions:version— required semver; starting at0.1.0.skills— path to the skill packs directory (./skills/). Codex requires the explicit path; Claude Code reads it by default.interface— the store-listing block Codex requires. IncludesdisplayName,shortDescription,longDescription,developerName,category,capabilities,websiteURL,privacyPolicyURL,termsOfServiceURL,defaultPrompt(max 3, ≤128 chars each),brandColor,logo,composerIcon.Why the full interface block
Codex's public docs show a 4-field "minimal" example, but every one of 10 sampled plugins in
openai/pluginsships the stricter internal spec (fullinterfaceblock,author.name, most optional interface fields). The stricter spec is what's actually required for submission. Full survey:team/references/wgll/codex-plugin.mdinzapier/agent-discovery.CLI syntax verification
The install commands in the README (
codex plugin marketplace add,codex plugin add <plugin>@<marketplace>) are verified against openai/codex#21396. Note that the ChatGPT Learn docs currently only surface the/pluginspicker; the CLI form is documented in the merged PR rather than the user-facing docs (which lag).Fields flagged for copy review before un-drafting
Reasonable defaults are in place, but these are marketing copy and deserve a real pass:
interface.shortDescription— currently"Programmatic access to Zapier's 9,000+ apps via the TypeScript SDK."interface.longDescription— currently a 2-sentence blurb from the README opening.interface.capabilities— currently[]. Shipping plugins sometimes populate this, sometimes leave it empty.interface.defaultPrompt— three starter prompts shown in the Codex plugin picker. Currently based on the SKILL.md triggers.What's next (not this PR)
zapier/marketplace's.agents/plugins/marketplace.json— required for the install commands in the README to actually work end-to-end.Test plan
python3 -m json.tool .codex-plugin/plugin.json— verified locally).zapier/marketplace, verifycodex plugin marketplace add zapier/marketplace && codex plugin add sdk@zapierinstalls the SDK skill end-to-end.interfacecopy before flipping this out of draft.