Native Codex plugin for structural code quality analysis over codeclone-mcp.
Same canonical MCP surface used by CLI, VS Code, Claude Desktop, and Claude Code.
Read-only, baseline-aware, local stdio only.
Current-run metric surfaces from the local codeclone-mcp version flow through
directly, including Coverage Join facts and the optional coverage help topic.
| File | Purpose |
|---|---|
.codex-plugin/plugin.json |
Plugin metadata and prompts |
.mcp.json |
Local stdio MCP definition |
scripts/launch_mcp |
Shell-free workspace-first launcher bootstrap |
skills/codeclone-review/ |
Conservative-first full review skill |
skills/codeclone-hotspots/ |
Quick hotspot discovery skill |
assets/ |
Plugin branding |
plugin.json keeps the machine identifier as lowercase codeclone; the
user-facing label stays in interface.displayName as CodeClone.
The plugin prefers a workspace launcher first:
./.venv/bin/codeclone-mcp- the current Poetry environment launcher
codeclone-mcpfromPATH
The bundled Codex launcher is a small repo-local Python wrapper, not a shell
snippet. It keeps the same workspace-first order without relying on sh -lc.
Recommended workspace-local setup:
uv venv
uv pip install --python .venv/bin/python "codeclone[mcp]"
.venv/bin/codeclone-mcp --helpIf your workspace uses Poetry, install CodeClone into that Poetry environment.
Global fallback:
uv tool install "codeclone[mcp]"
codeclone-mcp --helpCodex discovers the plugin from .agents/plugins/marketplace.json.
It does not rewrite ~/.codex/config.toml.
If you prefer manual MCP registration instead:
codex mcp add codeclone -- codeclone-mcp --transport stdiocodeclone-review — full structural review: conservative first pass, baseline-aware triage, changed-files review, deeper exploratory follow-up, current-run metrics surfaces.
codeclone-hotspots — quick quality snapshot: health check, top risks, single-metric queries, pre-merge sanity checks, coverage/adoption/API snapshots.