code-reviewer

code-reviewer — Pre-Push Multi-Agent Local Branch Review

code-reviewer is a Claude Code plugin that runs a non-interactive, multi-agent code review on the current local branch before you push it to GitHub. Where prr is for the reviewer (after a PR is opened), code-reviewer is for the author (right before they push): make the branch ready for human review by catching bugs, security issues, regressions, and missing tests automatically first.

Claude, Codex, Gemini, and opencode each review the branch diff against the base branch in parallel. A Claude-powered arbiter cross-examines disagreements and produces a single FINAL_REVIEW_RESULTS.md the implementing agent (and you) can act on directly.

Prerequisites

Required:

• Claude Code CLI — runs the plugin skills
• git — diff, log, merge-base
• jq — JSON config parsing
• python3 — Jira fetch and HTML→Markdown (stdlib only; no pip install)

Optional (enable additional reviewers):

• Codex CLI — codex agent
• Gemini CLI — gemini agent (uses Vertex AI; needs google_cloud_project / google_cloud_location)
• opencode — opencode agent. Requires OPENAI_API_KEY in your shell or opencode auth. The plugin does not store this key.

Project-side linters are auto-detected and run if present:

• Ruby: rubocop (uses .rubocop.yml if present)
• Python: ruff, mypy, flake8
• JS/TS: eslint, tsc
• Go: golangci-lint (or go vet)
• Rust: cargo clippy
• Shell: shellcheck

Plus tests: if the repo has a README.md, CLAUDE.md, AGENTS.md, or CONTRIBUTING.md with a test/build/spec section, reviewers extract those instructions and run the suite, flagging any regressions.

Installation

Inside a Claude Code session:

/plugin marketplace add cfactolerin/code_reviewer
/plugin install code-reviewer@cfactolerin-code-reviewer

Quick Start

Run once to configure agents and (optionally) Jira credentials:

/code-reviewer:setup

Then, when you have a branch ready to push:

/code-reviewer:start

Optional flags:

/code-reviewer:start --ticket ABC-123          # override Jira key
/code-reviewer:start --base origin/develop     # override base branch
/code-reviewer:start --delta                   # fast review: only material new since last review
/code-reviewer:start --full                    # re-download Jira/Confluence; review entire branch
/code-reviewer:start --no-prune               # keep all old round dirs (skip the 10-round prune)
/code-reviewer:start --ticket ABC-123 --base origin/release/v2

The skill runs all configured agents in parallel, the arbiter synthesises, and a final report is written to:

<review_output_path>/<repo-slug>/<branch-slug>/<YYYYMMDD-HHMMSS>/FINAL_REVIEW_RESULTS.md

(review_output_path defaults to /tmp/code-reviewer/ — see "Volatility note" below.)

After the review finishes, the skill hands back to the main Claude Code session with a prompt:

The code review found N findings (X critical, Y high, …). How would you like to proceed?

• Fix everything — apply fixes finding-by-finding, re-run for regression check
• Fix a subset — name the finding numbers to fix
• Discuss first — Q&A about findings before deciding
• Skip for now — leave the report and continue

Pick Fix everything for the typical case: the main session reads FINAL_REVIEW_RESULTS.md, applies fixes one by one (running each finding's acceptance check), then re-runs /code-reviewer:start. The previous report is automatically included in the next review's context, so the arbiter explicitly calls out regressions, items now fixed, and any newly introduced issues.

Skills

Skill	Description
/code-reviewer:setup	First-time setup — agent list, Jira credentials, GCP project/location
/code-reviewer:start [--ticket K] [--base R] [--delta|--full] [--no-prune]	Non-interactive multi-agent review of the current branch
/code-reviewer:autodetect [true|false]	Toggle the git push review gate (config.auto_trigger). No-arg form prints the current state
/code-reviewer:dismiss <fingerprint>	Add a finding fingerprint to DISMISSALS.md so it is excluded from future gate checks
/code-reviewer:add-agent <name>	Enable an agent in your config (claude, codex, gemini, opencode)
/code-reviewer:delete-agent <name>	Disable an agent in your config

How It Works