.local-review.yml — example: pin specific models, disable codex

llms: claude: model: claude-opus-4-7

gemini: model: gemini-2.0-flash api_key_env: GEMINI_API_KEY

codex: enabled: false # opt-out (still runs if --only codex is passed)

merge: preferred_llm: auto # or: claude, gemini, codex ```

See examples/.local-review-multi.yml for full schema.

.local-review.yml — every field is optional

prompts: prepend: | Additional house rules: - Never approve commented-out code. - Flag any new dependency in package.json or go.mod. review: min_severity: warning # nit | info | warning | major | critical

You can ship the whole pack of overrides this way — see [Customise for your team](#customise-for-your-team) below.

**4. Review your current branch** vs `main`:

Findings print to your terminal. The tool exits non-zero on major / critical, so it slots straight into a pre-commit hook.

5. (Optional) Check how the LLMs score on a labelled benchmark. The repo ships with bench/RESULTS.md — a leaderboard (precision / recall / F1 / noise, plus uplift-over-raw-LLM and overhead-vs-raw-LLM tables) generated from a 10-case dataset spanning Go / TS / Python / Rust. Refreshed before each release; you don't need to run anything locally. See bench/README.md for methodology.

---

Restrict to a subset (overrides config)

local-review review --only claude,gemini

Configure

local-review loads YAML from a cascade — built-in defaults → ~/.local-review.yml → ./.local-review.yml → CLI flags.

A minimal ~/.local-review.yml:

provider:
  base_url: https://api.openai.com/v1
  model: gpt-4o-mini
  api_key_env: LOCAL_REVIEW_API_KEY
review:
  min_severity: warning
  max_findings: 20

See examples/.local-review.yml for the full schema with comments.

Review (multi-LLM by default; falls back to single-LLM via configured provider if no CLI is active)

local-review review [<base>] # canonical: current branch vs <base> (default: main) local-review staged # review git diff --cached (pre-commit) local-review commit [<rev>] # review one commit (default: HEAD) local-review branch [<base>] # alias of review for muscle-memory