review

Run an Antigravity review through the shared plugin runtime.

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 Antigravity'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 the review in a Claude background task.
• Otherwise, estimate the review size before asking:
  • Use git status --short --untracked-files=all to see scope.
  • Use git diff --shortstat --cached and git diff --shortstat for working-tree changes.
  • Use git diff --shortstat <base>...HEAD if --base <ref> was passed.
  • Treat untracked files as reviewable work even when diff stats are empty.
  • Recommend waiting only when the review is clearly tiny (~1-2 files, no directory-scale change). Otherwise recommend background.
  • When in doubt, run the review rather than declaring 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.
• The companion script accepts --wait and --background but treats them as no-ops; Claude Code's Bash(..., run_in_background: true) is what actually detaches the run.
• /ask-antigravity:review does not take focus text. For steerable reviews, use /ask-antigravity:adversarial-review.

Foreground flow:

• Run:

node "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity-companion.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:

• Launch the review with Bash in the background:

Bash({
  command: `node "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity-companion.mjs" review "$ARGUMENTS"`,
  description: "Antigravity review",
  run_in_background: true
})

• Do not call BashOutput or wait for completion in this turn.
• After launching, tell the user the Antigravity review is running in the background and the output will appear in chat when it finishes.
• While waiting, completion arrives as a BashOutput notification from the harness. Do not poll temp directories, do not search for sidecar files (this plugin does not create any), and do not invoke agy or the companion script directly to "check status" — that runs a separate agy session and does not surface the in-flight one.