cc-plugin-codex by aiArch

cc-plugin-codex is an open-source Codex CLI plugin from aiArch that connects Codex with Claude Code for AI code reviews, delegated coding tasks, session handoffs, and background agent workflows.

This project is a refactor of OpenAI's Codex plugin for Claude Code. I created it because I use both Claude Code and Codex and was missing the same integration in Codex.

aiArch is the professional development membership for AI engineers. This independent project is not affiliated with Anthropic or OpenAI.

What You Get

• $claude-review for a normal read-only Claude Code review
• $claude-adversarial-review for a steerable challenge review
• $claude-rescue, $claude-transfer, $claude-status, $claude-result, $claude-cancel, and $claude-setup to delegate work, hand off sessions, and manage background jobs

In Codex, run /skills or type $ to select a skill. Slash commands such as /claude-review are not supported.

Requirements

• Claude Code CLI 2.1.218 or later, installed and authenticated. Use the official installer or npm, then run claude auth login. The npm installation requires Node.js 22 or later.
• Node.js 18.18 or later to run this plugin.

Install

Until the plugin is published in OpenAI's universal Plugins Directory for ChatGPT and Codex, register the repository marketplace and install it directly:

codex plugin marketplace add sofus-nl/cc-plugin-codex --ref main
codex plugin add cc-plugin-codex@cc-plugin-codex

Start a new Codex session so it discovers the installed skills, then run:

$claude-setup

$claude-setup reports whether Claude Code is installed, supported, and authenticated. It can offer npm installation when Node.js 22 or later is available.

Usage

• $claude-review [--wait|--background] [--base <ref>] [--scope <auto|working-tree|branch>] [--model <model>] — isolated read-only review of local changes or a branch diff.

• $claude-adversarial-review [--wait|--background] [--base <ref>] [--scope <auto|working-tree|branch>] [--model <model>] [focus text] — isolated read-only challenge review of the implementation and design.

• $claude-rescue [--wait|--background] [--resume|--fresh] [--write] [--model <model>] [--effort <level>] [prompt] — hands a task to Claude Code. Fix and implementation requests default to write-capable; diagnosis and review requests remain read-only.

• $claude-transfer [--source <codex-thread-id>] — starts a Claude Code session carrying the Codex thread ID.

  [!NOTE] This is not a transcript import. Only the thread ID is carried over; paste any required conversation context into the new Claude session.

• $claude-status [job-id] [--wait] [--timeout-ms <ms>] [--poll-interval-ms <ms>] [--all], $claude-result [job-id], and $claude-cancel [job-id] — inspect, wait for, retrieve, or cancel tracked jobs.

• $claude-setup [--enable-review-gate|--disable-review-gate] — checks Claude Code readiness and toggles an optional stop-time review notice.

  [!NOTE] This plugin currently implements the stop-time review as an advisory notice: it logs the result and does not request Codex to block or continue the session.

aiArch Resources

• The Claude Code workflow: how AI-native engineers actually run it
• Reviewing AI-written code: the diff discipline that keeps agents honest

License

Apache-2.0. See LICENSE and NOTICE.