feat(codex): add plugins/codex — MCP config + AGENTS.md skill#4
Closed
feat(codex): add plugins/codex — MCP config + AGENTS.md skill#4
Conversation
Codex CLI registers MCP servers via ~/.codex/config.toml rather than a packaged plugin manifest, so this "plugin" is pure configuration: - config.toml.example — the block users append to their Codex config to spawn @atomicmemory/mcp-server. Env mirrors the SDK V3 scope keys (user / agent / namespace / thread) with ATOMICMEMORY_SCOPE_* env vars, matching what mcp-server/src/config.ts expects. - AGENTS.md — skill body (when to search, when to ingest, what to skip) for pasting into a project or user AGENTS.md file. - README.md — three-step install (register, skill, verify) plus status: pre-release callout. No runtime code — all memory semantics live in packages/mcp-server. Matches the Claude Code plugin shape, adapted to Codex's config.toml surface.
Collaborator
Author
|
Closing — Codex plugin was shipped with the wrong config.toml format. Real Codex plugins use |
3 tasks
PipDscvr
added a commit
that referenced
this pull request
Apr 21, 2026
) * feat(codex): rewrite plugin in proper Codex plugin format Replaces the config.toml approach (PR #4, closed) with the actual Codex plugin manifest shape used by the Codex plugin marketplace: plugins/codex/ ├── .codex-plugin/plugin.json # Codex plugin manifest w/ interface │ # metadata (displayName, capabilities, │ # category, brandColor, defaultPrompt, │ # logo, links) ├── .codex-mcp.json # MCP server spec — stdio via │ # `npx @atomicmemory/mcp-server`, │ # env mirrors SDK V3 scope keys ├── skills/atomicmemory/ │ └── SKILL.md # memory protocol skill — on every │ # new task, after significant work, │ # before losing context ├── marketplace.example.json # template for .agents/plugins/ │ # marketplace.json (repo or user │ # level); users copy and point │ # source.path at this plugin dir ├── logo.svg # AtomicMem #3A60E4 icon ├── package.json # workspace membership (private) └── README.md Three install options documented: - Repo marketplace (recommended for teams) - Personal marketplace (~/.agents/plugins/marketplace.json) - Manual MCP config (skips the skill, just registers tools) No runtime code — all memory semantics live in packages/mcp-server. Matches the shape of mem0-plugin/.codex-plugin/ adapted for AtomicMemory's pluggable provider model and scope semantics. * fix(codex): use support@atomicmem.ai in plugin manifest * fix(codex): use atomicmem.ai for homepage + websiteURL * chore(codex): drop Mem0 positioning from plugin copy Description and longDescription in .codex-plugin/plugin.json used "swap between AtomicMemory and Mem0" as the pluggability pitch. Replace with generic language about the SDK's MemoryProvider model for alternative backends — same technical story, no third-party name in the Codex marketplace listing. Also drops the `# or "mem0"` comment from the ATOMICMEMORY_PROVIDER export in README. The enum value still works — users who need it can set it — but the README doesn't advertise it.
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.
Summary
Codex CLI plugin — pure configuration, no runtime code:
config.toml.example— block users append to~/.codex/config.tomlto spawn@atomicmemory/mcp-server. Env mirrors SDK V3 scope keys (user/agent/namespace/thread).AGENTS.md— skill body (when to search, when to ingest, what to skip) for pasting into a project or userAGENTS.md.README.md— three-step install (register MCP → paste skill → verify) + pre-release status callout.Matches the Claude Code plugin shape, adapted to Codex's
config.tomlsurface. All memory semantics live inpackages/mcp-server.Test plan
~/.codex/config.toml, startcodex, confirmatomicmemoryshows as an available MCP server (blocked on SDK publishing to npm)packages/mcp-server/src/config.tsenv var schemaScopeshape after PR fix: align scope + tokenBudget + role enum with SDK V3 surface #1