review

Run a Grok Build review through the plugin bridge (read-only write barrier: --no-plan, --sandbox read-only, disallowed write tools, and deny rules — not plan mode).

Raw slash-command arguments: $ARGUMENTS

Core constraint:

• This command is review-only.
• Do not fix issues, apply patches, or suggest that you are about to make changes.
• Your only job is to run the review and return Grok's output verbatim to the user.

Execution mode rules:

• If the raw arguments include --wait, do not ask. Run the review in the foreground.
• If the raw arguments include --background, do not ask. Run via the bridge background path (short Claude enqueue only).
• Otherwise, estimate the review size before asking:
  • For working-tree review, start with git status --short --untracked-files=all.
  • For working-tree review, also inspect both git diff --shortstat --cached and git diff --shortstat.
  • For base-branch review, use git diff --shortstat <base>...HEAD.
  • Treat untracked files or directories as reviewable work even when git diff --shortstat is empty.
  • Only conclude there is nothing to review when the relevant working-tree status is empty or the explicit branch diff is empty.
  • Recommend waiting only when the review is clearly tiny, roughly 1-2 files total and no sign of a broader directory-sized change.
  • In every other case, including unclear size, recommend background.
  • When in doubt, run the review instead of declaring that there is nothing to review.
• Then use AskUserQuestion exactly once with two options, putting the recommended option first and suffixing its label with (Recommended):
  • Wait for results
  • Run in background

Argument handling:

• Preserve the user's arguments exactly.
• Do not strip --wait or --background yourself.
• Do not add extra review instructions or rewrite the user's intent.
• --model, --effort, --timeout-ms, --max-turns, --base, and --scope are runtime-selection flags. Preserve them for the bridge call; do not treat them as review focus text.
• Leave --model and --effort unset unless the user explicitly asks for them. Accepted effort values: low, medium, high, xhigh — measured against the CLI rather than copied from its binary, which lists three more that the flag refuses.
• The bridge script parses --wait and --background. Bridge --background owns the long-running process group (detached run-worker + grok agent). Claude Code's Bash(..., run_in_background: true) is only for the short enqueue call, not the long review process.
• If both --background and --wait are present, --wait wins (foreground).
• Optional trailing positionals are focus text and are joined into the review prompt. /grok-build:review does not support staged-only or unstaged-only review scopes.
• Put every flag BEFORE the focus text. Option parsing stops at the first focus word, so a flag placed after it is read as part of the text — deliberately, because focus text is prose about code and may legitimately contain --json or --base.
• Exit codes and failureCode (including empty-output no-deliverable) are documented in the plugin README; return stdout/stderr unchanged on failure.
• If the user needs a tougher design challenge pass, they should use /grok-build:critique.

Foreground flow:

• Run:

node "${CLAUDE_PLUGIN_ROOT}/scripts/grok-bridge.mjs" review "$ARGUMENTS"

• Return the command stdout verbatim, exactly as-is.
• Do not paraphrase, summarize, or add commentary before or after it.
• Do not fix any issues mentioned in the review output.

Background flow:

• Prefer the bridge's own detached worker so stop owns a stable process group. Ensure the forwarded arguments include --background (add it if the user chose background and did not already pass the flag).
• Launch with Bash (Claude may still use run_in_background: true for the short enqueue call; the long-running work is the bridge run-worker):

Bash({
  command: `node "${CLAUDE_PLUGIN_ROOT}/scripts/grok-bridge.mjs" review --background "$ARGUMENTS"`,
  description: "Grok Build review",
  run_in_background: true
})

• Do not call BashOutput or wait for completion in this turn.
• After launching the command, tell the user: "Grok Build review started in the background. Check /grok-build:runs for progress. Stop with /grok-build:stop."