Skip to content

Add Codex CLI support and multi-agent plugin infrastructure#41

Merged
devstefancho merged 5 commits into
mainfrom
claude/codex-plugin-support-Zetnn
May 10, 2026
Merged

Add Codex CLI support and multi-agent plugin infrastructure#41
devstefancho merged 5 commits into
mainfrom
claude/codex-plugin-support-Zetnn

Conversation

@devstefancho
Copy link
Copy Markdown
Owner

Summary

Restructure the plugins marketplace to support both Claude Code and Codex CLI as first-class agents, with shared plugin content and parallel manifests. Introduce cross-agent guidance documentation and validation/sync scripts to keep the two agent ecosystems in lockstep.

Key Changes

  • New AGENTS.md — Shared guidance for all coding agents (Claude Code, Codex, Cursor, etc.), covering repository purpose, plugin layout, component compatibility matrix, and maintenance workflows. This becomes the single source of truth.

  • Refactored CLAUDE.md — Now references AGENTS.md and adds only Claude Code-specific details (local plugin development, Claude Code commands, hook format notes).

  • Dual plugin manifests — Each plugin now ships both:

    • .claude-plugin/plugin.json (Claude Code)
    • .codex-plugin/plugin.json (Codex CLI)

    Both manifests mirror each other in name, version, and description.

  • Dual marketplace catalogs:

    • .claude-plugin/marketplace.json (Claude Code source of truth)
    • .agents/plugins/marketplace.json (Codex CLI mirror)
  • New maintenance scripts:

    • scripts/sync-marketplace.sh — Mirrors Claude marketplace to Codex location with a rewritten description to reflect multi-agent intent.
    • scripts/validate-plugins.sh — Verifies every plugin has both manifests with matching metadata and that marketplace lists agree.
  • Updated README.md — Retitled to "Multi-Agent Plugins Marketplace," added Codex CLI quick-start section, documented dual marketplace locations, and clarified the plugin structure with both manifest types.

  • Added .codex-plugin/plugin.json to all 12 plugins — Each mirrors its Claude counterpart with identical name, version, and description.

Notable Details

  • The component compatibility matrix in AGENTS.md clarifies which parts are shared (skills, subagents) vs. tool-specific (hooks, MCP config format).
  • Skills and subagents use the same Markdown format across both tools, enabling true code reuse.
  • Slash commands are Claude Code native; Codex users access equivalent functionality via skills.
  • MCP servers are defined separately (.mcp.json for Claude, codex.config.toml.snippet for Codex) but reference the same underlying servers.
  • Validation and sync scripts ensure the two agent ecosystems never drift out of sync.

https://claude.ai/code/session_014yM8JMUkfjAnheCJ3t4yft

Make every plugin dual-installable from both Claude Code and Codex CLI by
publishing parallel manifests and a mirrored marketplace catalog. Skill,
agent, and command files stay shared between tools — only the manifests
and the catalog are duplicated.

- Add AGENTS.md as the cross-agent source of truth; reduce CLAUDE.md to a
  thin Claude-specific shim that imports it
- Add .codex-plugin/plugin.json to all 12 plugins, mirroring their
  .claude-plugin/plugin.json
- Add .agents/plugins/marketplace.json mirroring .claude-plugin/marketplace.json
- Add scripts/sync-marketplace.sh and scripts/validate-plugins.sh to keep
  the two manifests and catalogs in lockstep
- Update README with Codex install instructions and updated layout

https://claude.ai/code/session_014yM8JMUkfjAnheCJ3t4yft
@vercel
Copy link
Copy Markdown

vercel Bot commented May 9, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
claude-plugins Ready Ready Preview, Comment May 10, 2026 8:58am

Collapse the two-file shim setup into a single source of truth. AGENTS.md now
covers everything (universal + per-tool install/dev/iteration workflows) and
CLAUDE.md is a symlink so Claude Code reads the same content. Adds a
Maintenance Scripts section explaining what validate-plugins.sh and
sync-marketplace.sh do and when to run each.

https://claude.ai/code/session_014yM8JMUkfjAnheCJ3t4yft
…Codex sessions

When a session fills its context window, users typically open a fresh session
and ask the new agent to "pick up where we left off". Previously this required
a hand-typed prompt with a session UUID. This skill automates the lookup:

- Searches both ~/.claude/projects/**/*.jsonl and ~/.codex/sessions/**/rollout-*.jsonl
- With no argument, picks the most recently modified session (current cwd for
  Claude Code, globally for Codex) and uses whichever is newer
- With a UUID argument, finds the matching transcript across both tools
- Prints metadata (tool, branch, cwd, last activity) plus the last N messages

Adds session-resume-plugin to both marketplaces and maps it to the
"Productivity" category in scripts/sync-marketplace.sh.

https://claude.ai/code/session_014yM8JMUkfjAnheCJ3t4yft
The Claude Code Review GitHub Action chokes on the symlink with
"ENOENT: no such file or directory, symlink" while preparing its workspace.
Replacing the symlink with a regular file containing Claude Code's native
@AGENTS.md import achieves the same outcome (single source of truth, no
content duplication) without any filesystem-level redirects, so CI is
happy and Codex/Cursor still read AGENTS.md directly.

https://claude.ai/code/session_014yM8JMUkfjAnheCJ3t4yft
@devstefancho devstefancho merged commit 219acd2 into main May 10, 2026
3 checks passed
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