Claude Code Review for Codex

Use local Claude Code from inside Codex as an external reviewer or delegated rescue agent.

This is the reverse direction of openai/codex-plugin-cc: instead of adding Codex commands to Claude Code, this repository adds a Codex plugin skill and companion runtime that tells Codex how to ask the local claude CLI for review or delegated rescue work.

What You Get

• A Codex skill named claude-code-review
• review for staged, unstaged, untracked, and branch diffs
• adversarial-review for challenging design choices and assumptions
• task for handing investigation or implementation work to Claude Code
• status, result, and cancel for foreground/background job management
• setup checks for local Claude Code CLI and auth state
• A companion runtime modeled after openai/codex-plugin-cc

Requirements

• Codex CLI with plugin marketplace support
• Claude Code CLI installed as claude
• Claude Code authenticated with claude auth login
• Node.js 18 or newer
• A git repository to review

Install

Add this marketplace to Codex:

codex plugin marketplace add asdf17128/claude-code-review

Update an existing install:

codex plugin marketplace upgrade claude-code-review

Install or pin a specific Git ref:

codex plugin marketplace add asdf17128/claude-code-review@v0.2.0

Then ask Codex to use Claude Code review, for example:

Ask Claude Code to review my current changes.

For local development from this checkout:

codex plugin marketplace add /absolute/path/to/claude-code-review

Direct Helper Usage

The skill calls the companion runtime under the hood, but you can run it directly:

node plugins/claude-code-review/scripts/claude-companion.mjs setup
node plugins/claude-code-review/scripts/claude-companion.mjs review
node plugins/claude-code-review/scripts/claude-companion.mjs review --base main
node plugins/claude-code-review/scripts/claude-companion.mjs adversarial-review --base main "challenge the retry design"
node plugins/claude-code-review/scripts/claude-companion.mjs task --background --write "investigate the failing test"
node plugins/claude-code-review/scripts/claude-companion.mjs status
node plugins/claude-code-review/scripts/claude-companion.mjs result
node plugins/claude-code-review/scripts/claude-companion.mjs cancel <job-id>

The old helper name is kept as a compatibility wrapper:

node plugins/claude-code-review/scripts/claude-code-review.mjs review --base main

Notes

• Review commands do not edit files.
• task --write is the explicit write-capable path.
• Tests mock the Claude CLI and do not spend Claude usage.
• CLAUDE_CODE_REVIEW_CLAUDE_BIN=/path/to/claude overrides the Claude binary.

Test and Release

Run the full local gate before every release:

npm run ci
CODEX_HOME="$(mktemp -d)" codex plugin marketplace add "$PWD"

npm run ci runs the unit tests, JavaScript syntax checks, and plugin shape verification. The marketplace install command is the install smoke test that proves Codex can load the repository as a plugin marketplace.

Publishing is handled by GitHub Actions. Create a version tag that matches both package.json and .codex-plugin/plugin.json:

git tag v0.2.0
git push origin main v0.2.0

The release workflow verifies the tag/version match, runs npm run ci, installs the Codex CLI, performs the marketplace install smoke test, and then creates the GitHub Release.