Antigravity CLI
Google Antigravity CLI is the Google command-line runtime. Gemini remains a model family; do not invoke the retired gemini executable.
Workflow
- Verify the runtime with
agy --version. If it is unavailable, report that Antigravity CLI must be installed or repaired; do not fall back togemini. - Run
agy modelswhen model choice matters. Use a currently listed model and never hardcode a preview model from memory. - Give Antigravity a bounded prompt that names the files, question, required evidence, and output format.
- Prefer read-only review. Grant write or command permissions only when the user asked Antigravity to modify or execute something.
- Capture the result, verify actionable claims against the repository or tests, and distinguish Antigravity findings from confirmed facts.
Headless usage
agy -p "Review the authentication flow. Cite file:line evidence and list only actionable findings." --output-format json
Optional controls:
--model <id>: choose an ID returned byagy models.--effort <level>: tune reasoning effort when supported by the selected model.--output-format text|json|stream-json: select machine-readable output for automation.--continueor--conversation <id>: resume an existing Antigravity conversation.
Use a timeout supplied by the host runner for background jobs. Never use obsolete Gemini CLI flags such as --approval-mode, --sandbox, --yolo, or -i.
Permission boundary
Use Antigravity's configured permission policy for routine automation. --dangerously-skip-permissions bypasses safety prompts and is allowed only when the user explicitly authorized unrestricted tool execution for that run. A request for review or analysis alone is not that authorization.
Result contract
Return:
- the model ID used, when explicitly selected;
- the useful findings or recommendation;
- which claims were independently verified;
- any timeout, authentication, permission, or parse failure.
Do not present an Antigravity opinion as test evidence.