review

Review code using specialized agents. If a PR number is given, review that PR. If no arguments, auto-detect: review the current branch's PR if one exists, or self-review local changes if not.

Setup

air reviews GitHub PRs via the gh CLI (must be authenticated — gh auth login).

PLATFORM_DOMAIN builds the wiki + finding-link URLs below — derive it from the remote host so GitHub Enterprise (and SSH remotes) work, defaulting to github.com:

REMOTE_URL=$(git remote get-url origin 2>/dev/null)
if [[ "$REMOTE_URL" =~ ^https?://([^/]+)/ ]]; then
  PLATFORM_DOMAIN="${BASH_REMATCH[1]}"
elif [[ "$REMOTE_URL" =~ ^git@([^:]+): ]]; then
  PLATFORM_DOMAIN="${BASH_REMATCH[1]}"
else
  PLATFORM_DOMAIN="github.com"
fi

Step 0: Initialize Session Temp Directory

Before any /tmp write, mint a per-invocation session dir. Claude Code's Bash tool starts a fresh shell per call, so export doesn't persist — capture the literal path from the command below and interpolate it into every subsequent $AIR_TMP reference in this file. Also sweep stale dirs from crashed prior runs.

# GC old session dirs (>1 day) from crashed prior runs
find /tmp -maxdepth 1 -name 'air-*' -mtime +1 -exec rm -rf {} + 2>/dev/null

# Mint the session dir. `mktemp -d` guarantees a non-empty, non-colliding path.
AIR_TMP=$(mktemp -d "/tmp/air-XXXXXX")
# Repo root (used by Step 3.5 when writing `.air-checks.sh` — same-repo only).
# Falls back to empty when invoked from outside a git repo; Step 3.5 skips
# `.air-checks.sh` generation in that case.
REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
# Plugin root (used by Step 13's meta.py invocations and hooks).
# The pre-commit hook exports this for .air-checks.sh; review.md has to
# derive it independently since Claude Code doesn't pass it to slash
# commands. We resolve it via the canonical cache path; if the user has
# the plugin installed elsewhere, they can set AIR_PLUGIN_ROOT manually.
if [ -z "${AIR_PLUGIN_ROOT:-}" ]; then
  AIR_PLUGIN_ROOT=$(ls -1d ~/.claude/plugins/cache/air/air/*/ 2>/dev/null | sort -V | tail -1 | sed 's:/$::')
fi
if [ -z "$AIR_PLUGIN_ROOT" ] || [ ! -d "$AIR_PLUGIN_ROOT" ]; then
  echo "warning: AIR_PLUGIN_ROOT not resolvable; Step 13's auto-trigger counter will not increment this run" >&2
  AIR_PLUGIN_ROOT=""
fi
echo "$AIR_TMP"