name: antigravity description: Use Google Antigravity CLI (agy) for code review, adversarial review, debugging, long-running task delegation, or large-context investigation. Hands off to agy's large-context window when the host wants a second opinion or a background pass instead of solving the task file-by-file. Survives the June 18, 2026 gemini-cli sunset by depending only on the agy binary. allowed-tools: Bash, Glob, Read

antigravity — when to use the $antigravity shortcut

Reach for $antigravity when any of these apply:

• You want a second opinion on a non-trivial diff, refactor, or design choice.
• The task benefits from a large context window (cross-file review, repo-wide impact analysis, long log triage).
• You want to delegate a long-running task to the background so the host session can keep working — e.g. "investigate why CI started failing on main" or "draft a migration plan for switching from X to Y".
• You want an adversarial review of code that's about to ship.

Skip $antigravity for trivial one-line edits or anything that requires interactive back-and-forth tighter than agy's --print round trips.

Verbs

All verbs map to scripts/commands/<verb>.mjs and are byte-equivalent across Claude Code (/antigravity:<verb>), Codex CLI ($antigravity <verb>), agy native (agy plugin run antigravity <verb>), and standalone (npx antigravity-plugin <verb>).

| Verb | What it does | |----------|--------------| | setup | One-time OAuth wizard. Runs agy --print 'hi' in the foreground so the user can complete the Google OAuth flow visibly. Idempotent. | | review | Reviews the current git diff (or --base <ref>). Background-by-default; returns a job id. | | rescue | Delegates an investigation or fix to agy — e.g. $antigravity rescue why are the tests failing. Returns a job id. | | task | Generic long-running delegation. Supports --continue, --conversation <id>, --add-dir <path>, --wait, --foreground, --json. | | status | Shows a compact table of current and recent jobs (id, kind, phase, health, last progress). Surfaces any pending OAuth URL prominently. | | result | Prints the final output of a completed job by id. | | cancel | Sends SIGTERM to a running worker by job id. |

Auth requirements

agy 1.0.x is OAuth-only — there is no API-key path yet (tracked upstream as antigravity-cli#78).

1. Run $antigravity setup (or /antigravity:setup from Claude Code) once per machine / account.
2. agy prints an OAuth URL — open it in a browser, complete the Google flow.
3. agy persists the refresh token in its own credential store. Subsequent invocations of any verb run silently.

If a background worker hits the auth prompt (e.g. a fresh machine), it captures the OAuth URL and surfaces it on $antigravity status <job-id> so you can still complete auth from a non-interactive session.

Example prompts

$antigravity review --base main
$antigravity rescue investigate why the integration tests started failing after PR #42
$antigravity task --continue draft a migration plan from Sequelize to Drizzle
$antigravity status
$antigravity result 0193e2c9-...

Where this plugin lives (for Codex auto-discovery)

Codex picks this plugin up via:

• .codex-plugin/plugin.json — canonical Codex manifest.
• .agents/plugins/marketplace.json — Codex personal-marketplace descriptor.
• This SKILL.md at the plugin install root — skill-discovery entry.
• agents/openai.yaml — implicit-invocation interface (the $antigravity shortcut).

Claude Code, agy, and standalone hosts ignore the Codex-specific files and consume .claude-plugin/, plugin.json (root), and bin/antigravity.mjs respectively. See docs/INSTALL.md for per-host install recipes.