plugins/codex/REPORT.md
Snider 466fe9f5a6 feat(codex): mirror claude plugins and ethics modal
Summary:\n- added Codex marketplace registry plus awareness/ethics/guardrails sub-plugins\n- mirrored Claude plugin commands/scripts/hooks into codex api/ci/code/collect/coolify/core/issue/perf/qa/review/verify\n- embedded Axioms of Life ethics modal, guardrails, and kernel files under codex/ethics\n- added Codex parity report, improvements list, and MCP integration plan\n- extended Gemini MCP tools and docs for Codex awareness
2026-02-05 20:13:01 +00:00

66 lines
2.2 KiB
Markdown

# Codex Plugin Parity Report
## Summary
Feature parity with the Claude plugin suite has been implemented for the Codex plugin set under `core-agent/codex`.
## What Was Implemented
### Marketplace & Base Plugin
- Added Codex marketplace registry at `core-agent/codex/.codex-plugin/marketplace.json`.
- Updated base Codex plugin metadata to `0.1.1`.
- Embedded the Axioms of Life ethics modal and “no silly things with strings” guardrails in `core-agent/codex/AGENTS.md`.
### Ethics & Guardrails
- Added ethics kernel files under `core-agent/codex/ethics/kernel/`:
- `axioms.json`
- `terms.json`
- `claude.json`
- `claude-native.json`
- Added `core-agent/codex/ethics/MODAL.md` with the operational ethics modal.
- Added guardrails guidance in `core-agent/codex/guardrails/AGENTS.md`.
### Plugin Parity (Claude → Codex)
For each Claude plugin, a Codex counterpart now exists with commands, scripts, and hooks mirrored from the Claude example (excluding `.claude-plugin` metadata):
- `api`
- `ci`
- `code`
- `collect`
- `coolify`
- `core`
- `issue`
- `perf`
- `qa`
- `review`
- `verify`
Each Codex sub-plugin includes:
- `AGENTS.md` pointing to the ethics modal and guardrails
- `.codex-plugin/plugin.json` manifest
- Mirrored `commands/`, `scripts/`, and `hooks.json` where present
### Gemini Extension Alignment
- Codex ethics modal and guardrails embedded in Gemini MCP tools.
- Codex awareness tools return the modal content without shell execution.
## Known Runtime Constraints
- Gemini CLI currently logs unsupported hook event names (`PreToolUse`, `PostToolUse`). Hooks are mirrored for parity, but hook execution depends on runtime support.
- Shell-based command prompts are blocked by Gemini policy; MCP tools are used instead for Codex awareness.
## Files & Locations
- Codex base: `core-agent/codex/`
- Codex marketplace: `core-agent/codex/.codex-plugin/marketplace.json`
- Ethics modal: `core-agent/codex/ethics/MODAL.md`
- Guardrails: `core-agent/codex/guardrails/AGENTS.md`
## Next Artefacts
- `core-agent/codex/IMPROVEMENTS.md` — improvements beyond Claude capabilities
- `core-agent/codex/INTEGRATION_PLAN.md` — plan to integrate Codex and Claude via local MCP