feat(codex): repo marketplace so Codex users can install the plugin before the directory lists it - #8
Merged
Conversation
…efore the directory lists it Codex reads a plugin catalogue from .agents/plugins/marketplace.json in any GitHub repo (`codex plugin marketplace add tester-army/cli`), and the ChatGPT app shows the same file as a source in its Plugins tab. This gives Codex users the one-command install Claude Code users already have through .claude-plugin/marketplace.json, without waiting for the OpenAI Plugins Directory review. Tested with codex-cli 0.153.4: marketplace add, plugin list shows testerarmy@testerarmy-agent-skills, plugin add installs 1.0.0 and registers the hosted MCP server at https://tester.army/mcp, plugin remove cleans up. - .agents/plugins/marketplace.json: one plugin, source ./ (the repo root carries .codex-plugin/plugin.json), category Developer Tools, sign-in on install; marketplace name matches the Claude one. - scripts/check-plugin-manifests.sh + validate-plugin.yml: the new file is parsed and must name the same plugin, point at ./ and share the Claude marketplace name. - README: Codex install commands next to the Claude Code ones. Refs Linear GTM-82. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
okwasniewski
approved these changes
Sep 21, 2026
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
2 participants
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.
Why
Codex users have no way to install the TesterArmy plugin until the OpenAI Plugins Directory lists it, and that submission (Linear GTM-82) still waits on Business verification, a reviewer account and app PR #2409. Codex also reads plugin catalogues from GitHub repos:
.agents/plugins/marketplace.jsonat the repo root, added withcodex plugin marketplace add owner/repo, and the ChatGPT desktop app shows the same file as a source in its Plugins tab. This is the Codex twin of the Claude Code marketplace this repo already is.What changes
.agents/plugins/marketplace.json: one plugin,testerarmy, source./(the root already carries.codex-plugin/plugin.jsonand the portableplugin.json), category Developer Tools, sign-in on install. Marketplace nametesterarmy-agent-skills, the same as the Claude marketplace, so the install command reads the same on both:scripts/check-plugin-manifests.shandvalidate-plugin.yml: the new file is parsed, must name the same plugin asplugin.json, point at./, and share the Claude marketplace name. CI runs on PRs touching.agents/plugins/**.README: the two Codex commands next to the Claude Code ones, plus the sign-in note.
Verification
Tested with codex-cli 0.153.4 on this branch:
codex plugin marketplace add <local checkout>andcodex plugin marketplace add lil-bsz/cli --ref codex/repo-marketplace(GitHub source) both register the marketplacecodex plugin listshowstesterarmy@testerarmy-agent-skills 1.0.0codex plugin add testerarmy@testerarmy-agent-skillsinstalls to~/.codex/plugins/cache/testerarmy-agent-skills/testerarmy/1.0.0andcodex mcp listthen showstesterarmy https://tester.army/mcp(not logged in untilcodex mcp login testerarmy)codex plugin removeandmarketplace removeclean up fullyAfter merge
Nothing to configure. The two commands above work for anyone with Codex. When the directory listing goes live, the repo marketplace keeps working alongside it.
🤖 Generated with Claude Code