Skip to content

feat(codex): add codex plugin and root marketplace - #3

Closed
minhthanhdang wants to merge 3 commits into
minh/rm-18349from
minh/rm-18419
Closed

minhthanhdang wants to merge 3 commits into
minh/rm-18349from
minh/rm-18419

Conversation

@minhthanhdang

Copy link
Copy Markdown
🚥 Resolves RM-18419

Stacked on #2, merge that first.

🧰 Changes

Adds the Codex plugin under codex/ and a marketplace file at the repo root, so codex plugin marketplace add readmeio/readme-plugins followed by codex plugin add readme@readme installs it. It uses the portable Agent Plugins layout (root plugin.json and mcp.json) with the com.openai interface block, which is the format OpenAI's current docs recommend and Codex 0.154.0 installs cleanly.

The MCP server ships anonymous: Codex strips Authorization from plugin MCP configs, so the README tells users to register the server with codex mcp add and --bearer-token-env-var for write access. Skills are a copy of claude/skills for now.

🧬 QA & Testing

  • Installed from a local checkout with Codex 0.154.0: plugin shows installed, enabled, all three skills load as readme:*.

@minhthanhdang
minhthanhdang requested review from xavierandueza and removed request for xavierandueza September 11, 2026 11:43
@xavierandueza
xavierandueza self-requested a review September 14, 2026 00:30

@xavierandueza xavierandueza left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a nit on these - if we're doing things to publish these do we want skills in the individual folders vs having them at root?

WOuld be great to have a single source of truth, but not the end of the world if we can't

Comment thread codex/mcp.json
"mcpServers": {
"readme": {
"type": "streamable-http",
"url": "https://docs.readme.com/mcp"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

how come no bearer here? Is that just the way that the codex plugins work?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yea.
re: skills at root

  • Onboarding skills will be different for Claude and Codex.
  • Can't submit to Claude if skills folder is outside the specified root

I'll leave it for now. To my engineering principles except when there is a published plugin standard agreed by all LLM providers, it's useless to think about a shared folder between them.

@minhthanhdang
minhthanhdang added this pull request to stack #4 September 14, 2026 01:26
@minhthanhdang

Copy link
Copy Markdown
Author

Moved to readmeio/agent-plugins#3. Same commits, same stack. The only content changes are the readmeio/readme-plugins marketplace references, now pointing at readmeio/agent-plugins.

Closing here. @xavierandueza sorry, the approval does not travel with the move, so the new PR needs a fresh look.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants