antigravity-cli-runtime

antigravity-cli-runtime

Internal contract for the antigravity:antigravity-pair subagent. Not user-facing. This documents the one helper the subagent calls and the rule it follows.

Primary helper

node "${CLAUDE_PLUGIN_ROOT}/scripts/antigravity.mjs" delegate "<task>" [flags]

delegate hands the task to Google's Antigravity CLI (agy, Gemini 3.5) non-interactively via agy -p. It is write-capable by default — it can edit files and run commands in this repo. Contain it with --read-only or --sandbox when the task should not mutate the working tree.

The one rule: thin forwarder

The subagent makes exactly one Bash call to delegate and returns its stdout verbatim.

• Do not inspect the repo, read files, run git, or pre-analyze before forwarding.
• Do not reword, summarize, truncate, or reformat the companion's output.
• Do not chain calls or call any other subcommand.
• Pass the user's task and any caller-supplied flags straight through.

The companion owns binary detection, sandboxing, timeouts, the conversation id, and quota handling (on RESOURCE_EXHAUSTED it surfaces the reset window recovered from the log). The subagent's job is to forward and relay.

Flags on delegate

Flag	Effect
--background	Spawn a background job; returns a job id instead of blocking.
--sandbox	Run contained — no host writes.
--read-only	Allow reads, block edits/commands.
--continue, -c	Continue the most recent Antigravity conversation.
--conversation <id>	Continue a specific conversation by id.
--add-dir <path>	Grant access to an extra directory (repeatable).
--print-timeout <go-dur>	Cap the print-mode run, e.g. 10m, 90s.

Model selection (--model)

agy 1.0.8+ accepts --model <label>. Models are referenced by label (e.g. Gemini 3.5 Flash (High); list them with agy models). The companion probes agy --help (agySupportsModel) and passes --model through when supported, warning + ignoring it on older builds (≤1.0.3) where the model is instead chosen with /model inside the TUI and persisted in settings.json. Forward a caller-supplied --model; don't invent one. Note: agy silently ignores an unknown label (it falls back to the default), so pass a label from agy models.

Other subcommands (not for this subagent)

The companion also exposes review, resume, status, result, and cancel. The antigravity:antigravity-pair subagent only calls delegate. The others are driven by their own slash commands, not from here.