agentic-peer-review

agentic-peer-review

A Claude Code plugin that peer-reviews your code with AI agents. agentic-peer-review spawns an AI code reviewer (Claude, Codex, or Gemini), implements the recommended fixes, and repeats until the reviewer is satisfied with the codebase.

Quickstart

Open Claude Code and paste the following:

/plugin marketplace add gideonshaked/[email protected]

/plugin install agentic-peer-review@agentic-peer-review

Then run peer review on the current workspace:

/peer-review

Install • Usage • Options • Checks

Install

Getting started

From the terminal:

claude plugin marketplace add gideonshaked/[email protected]
claude plugin install agentic-peer-review@agentic-peer-review

Or from inside Claude Code:

/plugin marketplace add gideonshaked/[email protected]

/plugin install agentic-peer-review@agentic-peer-review

Install from latest commit

From the terminal:

claude plugin marketplace add gideonshaked/agentic-peer-review
claude plugin install agentic-peer-review@agentic-peer-review

Or from inside Claude Code:

/plugin marketplace add gideonshaked/agentic-peer-review

/plugin install agentic-peer-review@agentic-peer-review

Updating

From the terminal:

claude plugin marketplace update agentic-peer-review
claude plugin update agentic-peer-review@agentic-peer-review

Or from inside Claude Code:

/plugin marketplace update agentic-peer-review

Then open /plugin, go to the Installed tab, and update the plugin from there.

Requirements

• Claude Code
• uv
• Codex CLI (only required for using OpenAI Codex as a reviewer agent)
• Gemini CLI (only required for using Google Gemini as a reviewer agent)

Usage

Help

To see all available options, in Claude Code run:

/peer-review -h

usage: peer-review [-h] [-V] [--agent {claude,codex,gemini}]
                   [--max-rounds MAX_ROUNDS] [--focus FOCUS]
                   [--timeout TIMEOUT] [--worktree] [--log LOG] [--only ONLY]
                   [--skip SKIP]
                   [instructions]

  Iterative AI peer review that finds and fixes issues in your codebase

  positional arguments:
    instructions          Optional review instructions

  options:
    -h, --help            show this help message and exit
    -V, --version         show program's version number and exit
    --agent {claude,codex,gemini}
                          AI agent to use for review (default: claude)
    --max-rounds MAX_ROUNDS
                          Maximum review-fix cycles (default: 5). Stops early if
                          no issues found.
    --focus FOCUS         Narrow review scope to a specific file or directory
                          path
    --timeout TIMEOUT     Timeout in seconds for each review agent invocation
                          (default: 300)
    --worktree            Run fixes in a git worktree. Each round is committed
                          separately and ported as individual commits on merge.
                          Shows diff at end and asks to merge or discard
    --log LOG             Write findings and fix/skip decisions to the specified
                          file
    --only ONLY           Comma-separated list of checks to run (default: all).
                          Available: architecture, bugs, dead-code, performance,
                          security, tech-debt
    --skip SKIP           Comma-separated list of checks to exclude. Available:
                          architecture, bugs, dead-code, performance, security,
                          tech-debt

Options