antigravity-cli

The saved excerpt is a snapshot from when this skill was listed. The external source remains the complete and most current version.

---
name: antigravity-cli
description: "Expert guide for Google's Antigravity CLI (agy), the official successor to Gemini CLI. Use when the user mentions 'agy', 'antigravity', 'antigravity cli', 'gemini cli replacement', 'gemini cli migration', or any task involving the agy command-line tool including running prompts, managing plugins, resuming sessions, or automating agy in scripts and CI/CD pipelines."
version: 1.3.0
---

# Antigravity CLI (agy) Skill

Targets locally installed `agy` v1.3.0 (with complete feature coverage through v1.2.17).

Use this skill to guide AI coding agents, automate CI/CD pipelines, orchestrate multi-agent swarms, configure Model Context Protocol (MCP) servers, manage custom Markdown agents, and control workspace environments with the `agy` CLI.

## Context: Gemini CLI Successor

The `agy` CLI is Google's official replacement for Gemini CLI, announced at Google I/O on May 19, 2026. Gemini CLI ceased serving requests for consumer and free users on June 18, 2026. Enterprise users on Gemini Code Assist Standard/Enterprise retain Gemini CLI access indefinitely.

Key architectural characteristics:
- **Go binary** (not Node.js) — instant startup latency, zero npm dependencies, bundled embedded `ripgrep` engine.
- **Unified agent platform** — shares the identical agent harness, runtime, and customization engine as the Antigravity IDE desktop application.
- **Plugin system** — replaces legacy Gemini CLI extensions (`agy plugin import gemini` to migrate).
- **High tool limit** — supports up to **512 tool calls** per turn on Gemini models for deep multi-step agentic execution.
- **Binary identification** — `agy` (primary executable), `antigravity` (certain Linux distributions). Set the `ANTIGRAVITY_CLI_ALIAS` environment variable to override binary resolution.
- **Default install path** — typically `~/.local/bin/agy`.

## Complete Command-Line Flag Reference

### Primary Command: `agy [flags] [prompt]`

| Flag | Shorthand | Description | Added / Updated |
| :--- | :--- | :--- | :--- |
| `--print` | `-p`, `--prompt` | Runs a single prompt non-interactively and prints the response. | v1.0.0+ |
| `--input-format <fmt>` | | Input format for print mode: `text` (default) or `stream-json`. `stream-json` reads NDJSON messages line-by-line from stdin for continuous multi-turn sessions. Requires `--output-format stream-json`. | v1.1.15+ |
| `--output-format <fmt>` | | Output format for print mode: `text` (default), `json`, or `stream-json` (strongly-typed NDJSON event stream). | v1.1.8+ |
| `--json-schema <schema>` | | Enforces a JSON schema on print mode output. Accepts an inline JSON schema string or a path to a schema file. Must have `"type": "object"` at the root; bare types fail at startup. | v1.1.8+, v1.2.14+ |
| `--effort <level>` | | Reasoning effort for the session: `low`, `medium`, `high`, `xhigh`, `max`. | v1.1.5+, v1.2.11+ |
| `--disable-slash-commands`| | Disables automatic expansion of leading slash commands and skills in headless print mode (`-p`). | v1.1.9+ |
| `--prompt-interactive` | `-i` | Runs an initial prompt interactively in the TUI and continues the session. | v1.0.0+ |
| `--continue` | `-c` | Continues the most recent conversation in the current workspace (with parent/child directory fallback). | v1.0.0+, v1.2.1+ |
| `--conversation <id>` | | Resumes a specific conversation by its unique ID. | v1.0.0+ |
| `--dangerously-skip-permissions` | | **CRITICAL FOR AUTOMATION.** Auto-approves all tool permission requests without interactive prompts. | v1.0.0+ |
| `--sandbox` | | Runs terminal operations in a secure restricted sandbox. | v1.0.1+ |
| `--agent <agent>` | | Specifies a custom agent (Markdown or built-in) for the current CLI session. | v1.1.1+, v1.2.11+ |
| `--model <model>` | | Model slug or identifier for the current CLI session. | v1.0.5+, v1.1.22+ |
| `--mode <mode>` | | Sets agent execution mode: `default` (request review), `accept-edits`, or `plan`. | v1.1.0+ |
| `--print-timeout <dur>`