antigravity-cli

name	antigravity-cli
description	Internal runtime contract for invoking the Antigravity CLI (`agy`) from the `agy` subagent. Not user-invocable.
user-invocable	false

Antigravity CLI runtime

Use this skill only inside the agy subagent.

Primary helper

bash "${CLAUDE_PLUGIN_ROOT}/scripts/agy-run.sh" ask [--model <alias>] "<prompt>" [agy-flags...]

The wrapper:

• Locates agy in PATH, ~/.local/bin, /opt/antigravity/bin, or /usr/local/bin.
• Verifies auth (system keyring OAuth or ANTIGRAVITY_API_KEY).
• Runs agy -p "<prompt>" non-interactively.
• If --model <alias> is supplied before the prompt, resolves the alias and applies it for the duration of the call (atomic patch of ~/.gemini/antigravity-cli/settings.json under a lockfile, restored on exit).
• Forwards any extra arguments after the prompt straight to agy — so … ask "<prompt>" --sandbox becomes agy -p "<prompt>" --sandbox.

Rules of engagement

One wrapper call per task. The subagent is a forwarder, not an orchestrator — keep the user's task text intact and let agy do the work.

Strip flags that belong to the parent slash command (--background) before forwarding. Pass --model <alias> to the wrapper (not to agy directly). Pass agy-native flags through after the prompt argument.

Model aliases (consumed by the wrapper)

flash-low, flash-medium (flash-med), flash (flash-high), pro-low, pro (pro-high), sonnet (claude-sonnet), opus (claude-opus), gpt-oss (gpt-oss-120b). Canonical TUI strings are also accepted verbatim (e.g. "Claude Opus 4.6 (Thinking)").

Run bash "${CLAUDE_PLUGIN_ROOT}/scripts/agy-run.sh" help for the authoritative list.

agy-native flags worth knowing

Run agy --help for the full list. Useful ones that go after the prompt argument:

• --sandbox — extra-restrictive execution; only when the user asked for it.
• --print-timeout 10m — extend the default 5min print timeout.
• --add-dir <path> — add a directory to the workspace (repeatable).

What this skill does NOT do

• Does not install or authenticate agy. That is /agy:setup's job.
• Does not retry, summarize, or post-process agy's output.
• Does not read files, run git, or make HTTP calls outside the wrapper.

Error handling

If the wrapper exits non-zero, return its stderr verbatim. Standard exit codes:

• 127 — agy binary not found.
• 1 — not authenticated, no diff found (review subcommand), or settings.json missing/malformed (--model path).
• 64 — bad CLI usage of the wrapper itself, or unknown --model alias.