NAME¶

review - Review the current diff using goose

SYNOPSIS¶

review [--prompt] [--model] [--provider] [--override-model] [--turn-limit] [--dry-run] [-q|--quiet] [--no-orchestrate] [-i|--instructions] [-f|--files] [-c|--check-filter] [-s|--check-scope] [--checks-only] [--summary-only] [--severity] [-h|--help] [RANGE]

DESCRIPTION¶

Local code review.

Discovers `**/.agents/checks/*.md` subagent reviewers and `**/.agents/REVIEW.md` scoped prompt overrides, builds a review request from the working tree (or an explicit diff range), and runs the review through goose.

OPTIONS¶

--prompt <FILE>

Path to a Markdown file with a custom base review prompt. Replaces the embedded default prompt

--model <MODEL>

Default model used for the main review agent and for any check that does not declare its own `model:` in frontmatter

--provider <PROVIDER>

Provider for the main review agent

--override-model <MODEL>

Force every discovered check to use this model, regardless of the check's own `model:` field

--turn-limit <N>

Default `turn-limit` for orchestrated main-pass subprocesses and for checks that do not declare their own. Does not cap the legacy `--no-orchestrate` in-process main agent

--dry-run

Print the assembled review prompt and discovered checks instead of running the review

-q, --quiet

Suppress non-result output from the underlying agent

--no-orchestrate

Disable the Rust-driven parallel orchestrator and fall back to the single-prompt path that asks the main agent to delegate each check via `delegate(... async: true ...)`. The default orchestrator dispatches one `goose run` subprocess per check (capped at 4 concurrent), bounding wall-clock to the slowest single check rather than waiting on the model to issue dispatches. Checks with an explicit tool allowlist require the default orchestrator

-i, --instructions <TEXT>

Additional free-form instructions to prepend to the review (e.g. PR intent, commit-message context, "this is a refactor, flag any behavior change"). Mirrors `amp review --instructions` for drop-in compatibility with existing reviewer wrappers

-f, --files <FILE>...

Restrict the review to a specific set of files. Other files in the diff are still passed to the agent for context but are excluded from the assembled diff sent to checks. Mirrors `amp review --files`

-c, --check-filter <NAME>...

Only run checks whose `name` matches one of these. Other discovered checks are skipped. Mirrors `amp review --check-filter`

-s, --check-scope <DIR>

Alternate directory to search for `.agents/checks/*.md` instead of the repo root. Mirrors `amp review --check-scope`

--checks-only

Skip the main correctness pass and only run check subagents. Mirrors `amp review --checks-only`

--summary-only

Print only the diff summary; skip the full review. Mirrors `amp review --summary-only`

--severity <LEVEL> [default: medium]

Minimum severity to display. Findings below this rank are dropped from the output. Default is `medium`, matching Amp's CLI which hides `low` from review output. Pass `--severity low` to surface every finding

-h, --help

Print help (see a summary with '-h')

[RANGE]

Diff range to review (e.g. "main...HEAD"). Defaults to the working tree vs HEAD

SEE ALSO¶

goose(1), goose-acp(1), goose-completion(1), goose-configure(1), goose-doctor(1), goose-gateway(1), goose-info(1), goose-mcp(1), goose-plugin(1), goose-recipe(1), goose-run(1), goose-schedule(1), goose-serve(1), goose-session(1), goose-skills(1), goose-term(1)