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
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-reviewer@awesome-codex-pluginsWhat 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-reviewondocs/features/search/plan.mdto check edge cases. - Compare current changes against the approved plan with
implementation-review. - Verify
docs/features/search/shipped.mdagainst git diff usingshipped-review.
How to install codex-reviewer
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install codex-reviewer@awesome-codex-pluginsStep 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