Skip to content

feat(codex): Codex plugin marketplace distribution path#8

Merged
Filip-Podstavec merged 7 commits into
mainfrom
feat/codex-plugin-dist
Jun 4, 2026
Merged

feat(codex): Codex plugin marketplace distribution path#8
Filip-Podstavec merged 7 commits into
mainfrom
feat/codex-plugin-dist

Conversation

@Filip-Podstavec

Copy link
Copy Markdown
Owner

What & why

OpenAI Codex shipped a plugin marketplace whose format is close to Claude Code's. This adds a third, complementary Codex distribution path: install claude-leverage from a Codex plugin marketplace, alongside the existing native .codex/ install script and AGENTS.md native read.

Design: docs/superpowers/specs/2026-06-03-codex-plugin-distribution-design.md · rationale: ADR 0011.

What's included

  • scripts/gen-codex-plugin.py — stdlib-only generator (mirrors gen-codex-agents.py) that derives the Codex artifacts from the single source of truth .claude-plugin/:
    • .codex-plugin/plugin.json (Codex reads only this — no legacy fallback for the manifest)
    • .agents/plugins/marketplace.json (canonical Codex marketplace path)
  • CI + smoke parity gatecodex-plugin-parity job + smoke-plugin.sh gate 3b run --check so the three manifests can't drift.
  • tests/test_codex_plugin_sync.py — 3 tests: generator output matches committed artifacts + version agreement.
  • README — Codex section now documents two paths (A: plugin marketplace, B: full-stack script); corrected the stale "Codex has no plugin marketplace" claim in README + install-codex.sh.
  • ADR 0011 + maintaining.md regenerate step.

How it works

  • Hooks work unchanged — Codex sets CLAUDE_PLUGIN_ROOT for compatibility, so the same hooks/hooks.json resolves in both tools.
  • Skills are already cross-tool (SKILL.md).
  • Codex plugins don't load slash commands or subagents — those remain on the install-script path (documented as complementary, not a regression).

Verification

  • gen-codex-plugin.py --check, gen-codex-agents.py --check, check_version_sync.py all green (1.11.0)
  • ✅ pytest: 3 new + 180 total, 0 failures
  • ⚠️ Not yet done: a live /plugins install in Codex CLI. One open detail — policy.authentication is omitted for this app-less plugin (assumed not required); confirm via a real test-install. Tracked in ADR 0011 + an AIDEV-NOTE in the generator. Merge after that live check passes.

🤖 Generated with Claude Code

Scrub a real company name from an illustrative fixture/example dir name in
the ai-first-nudge regression test, its hook comment, and the v1.4.1
changelog note. Pure string rename; the dir name still contains 'test' so
the regression premise is unchanged.
Bump plugin.json + marketplace.json to 1.12.0, regenerate the Codex artifacts
(.codex-plugin/plugin.json, .agents/plugins/marketplace.json) from source, and
add the CHANGELOG entry for the feature shipped on this branch.
@Filip-Podstavec Filip-Podstavec merged commit e3da9ea into main Jun 4, 2026
6 checks passed
@Filip-Podstavec Filip-Podstavec deleted the feat/codex-plugin-dist branch June 4, 2026 20:39
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.

1 participant