Skip to main content
plugin CX Codex

codex-reviewer — Claude Code plugin: what it does, how to install

codex-reviewer runs a secondary audit over AI-authored plans and pull requests. Catches architectural blind spots and unverified code before merge.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-reviewer@awesome-codex-plugins
Open on GitHub

What codex-reviewer does

This plugin introduces an external review layer for doc-driven workflows. When Claude drafts or updates project artifacts like plan.md or delivers code, an independent pass inspects the changes. Feedback can be pushed directly to GitHub pull requests through the gh command-line tool.

Three specialized skills handle the pipeline: plan-review spots missing scope and testing flaws, implementation-review validates modifications against original specs, and shipped-review ensures release summaries reflect genuine code evidence.

Because the skills inspect structured project documents, teams that skip writing markdown plans will get very little value from this setup.

What it helps with

  • Spot missing scope and sequence errors before coding begins
  • Verify that committed code matches the approved plan
  • Detect missing regression tests in drafted PRs
  • Validate release notes against actual code diffs

Example prompts for the agent

  • Run plan-review on docs/features/search/plan.md to check edge cases.
  • Compare current changes against the approved plan with implementation-review.
  • Verify docs/features/search/shipped.md against git diff using shipped-review.

How to install codex-reviewer

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-reviewer@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about codex-reviewer

How to install codex-reviewer in Claude Code?

Run these two commands in order: /plugin marketplace add hashgraph-online/awesome-codex-plugins and then /plugin install codex-reviewer@awesome-codex-plugins.

What does codex-reviewer do?

It acts as a quality gate, evaluating planning documents, code diffs, and shipped checklists against each other.

What is required to post feedback to GitHub?

Posting reviews directly to pull requests requires an authenticated gh CLI binary in your environment.

Source text

codex-reviewer · MIT
# Codex Reviewer

Codex plugin for running a second-pass review over Claude-driven work.

This plugin is designed for a doc-driven workflow:

- Claude captures or updates `idea.md`, `plan.md`, and `shipped.md`.
- Claude implements the code change.
- Codex reviews the artifacts and the implementation before you treat the work as complete.

The plugin ships three focused skills:

- `plan-review`: review ideas and plans for missing scope, hidden dependencies, sequencing mistakes, and weak test strategy
- `implementation-review`: review code changes against the approved plan and call out bugs, regressions, and missing tests
- `shipped-review`: verify that `shipped.md` matches the code and test evidence instead of overstating what landed

## Install

Codex supports two practical local install patterns for plugins:

- a personal marketplace at `~/.agents/plugins/marketplace.json`
- a repo marketplace at `$REPO_ROOT/.agents/plugins/marketplace.json`

For most users, the personal marketplace is the right default.

### Personal install

1. Clone this repository somewhere local:

```bash
git clone [email protected]:schuettc/codex-reviewer.git
```

2. Copy it into your Codex plugins directory:

```bash
mkdir -p ~/.codex/plugins
cp -R ./codex-reviewer ~/.codex/plugins/codex-reviewer
```

3. Create or update `~/.agents/plugins/marketplace.json`:

```json
{
  "name": "local-personal",
  "interface": {
    "displayName": "Local Personal"
  },
  "plugins": [
    {
      "name": "codex-reviewer",
      "source": {
        "source": "local",
        "path": "./plugins/codex-reviewer"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}
```

4. Restart Codex.

5. In Codex CLI, open the plugin surface:

```text
codex
/plugins
```

### Repo install

If you want the plugin available only for one repository:

1. Copy this repo into your project under `$REPO_ROOT/plugins/codex-reviewer`
2. Create or update `$REPO_ROOT/.agents/plugins/marketplace.json`
3. Point the plugin entry at `./plugins/codex-reviewer`
4. Restart Codex

Example repo marketplace:

```json
{
  "name": "local-repo",
  "interface": {
    "displayName": "Local Repo"
  },
  "plugins": [
    {
      "name": "codex-reviewer",
      "source": {
        "source": "local",
        "path": "./plugins/codex-reviewer"
      },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Productivity"
    }
  ]
}
```

### Updating

After you change the plugin, update the plugin directory your marketplace points to and restart Codex so it reloads the local install.

Examples:

```text
Use plan-review on docs/features/my-feature/plan.md.
```

```text
Use implementation-review on the current changes and compare them to the approved plan.
```

```text
Use shipped-review on docs/features/my-feature/shipped.md and verify the claims against the codebase.
```

Recommended operating model:

1. Let Claude drive ideation, drafting, and first-pass implementation.
2. Invoke Codex Reviewer before merge, especially on risky plans or broad refactors.
3. Treat findings as quality gates. Fix or consciously waive them.

## Repository Layout

This repository is already laid out as a standalone plugin:

```text
.codex-plugin/plugin.json
skills/plan-review/SKILL.md
skills/implementation-review/SKILL.md
skills/shipped-review/SKILL.md
```

© schuettc · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Code review and refactoring →

From the same set391

The whole set →
codex-tui-proof codex-tui-proof is a Claude Code plugin for checking terminal UIs in Codex's browser with keyboard input and screenshots. It runs from a TUI validation request. CX Codex ★ 1,596repo stars codex-tasklist codex-tasklist is a plugin for Codex CLI that creates a live task panel, saves state to SQLite, and switches to tmux when native terminal panels are unavailable. CX Codex ★ 1,596repo stars codex-skin-pack-installer The codex-skin-pack-installer plugin stages and checks public-safe Codex skin packs from GitHub releases. Use it when a custom background, artwork, and a visible restore path matter. CX Codex ★ 1,596repo stars codex-rg-guard codex-rg-guard is a Claude Code plugin that narrows broad repository searches through a budgeted MCP tool. It selects files before returning bounded line matches. CX Codex ★ 1,596repo stars codex-quota-title codex-quota-title shows remaining Codex quota and reset time in the Codex Desktop window title on Windows. The original title stays visible. CX Codex ★ 1,596repo stars codex-quota-optimizer codex-quota-optimizer is a Claude Code plugin that routes tasks to an adequate model and narrows repository context. It also applies layered checks. CX Codex ★ 1,596repo stars codex-process-jobs codex-process-jobs runs local builds, tests, and benchmarks as detached background processes on macOS and Linux, keeping status and logs after the agent turn ends. CX Codex ★ 1,596repo stars codex-multi-auth codex-multi-auth is a Claude Code and Codex plugin for managing ChatGPT accounts used by the official Codex CLI. It switches accounts and checks their health. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open