{
  "id": "antigravity-cli",
  "name": "Antigravity CLI",
  "vendor": "Google",
  "tagline": "The terminal-first surface to interact with Antigravity agents.",
  "subtitle": "terminal reference",
  "docsHome": "https://antigravity.google/docs/overview?tab=cli",
  "version": "1.5.3",
  "lastVerified": "2026-11-09",
  "stale": false,
  "accent": "#4fc3d9",
  "headerNote": "Google's successor to Gemini CLI for free, Google AI Pro and Ultra accounts, which [moved to Antigravity CLI on June 18, 2026](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/). It shares its agent harness and common settings with the Antigravity 2.0 desktop app. `/help` lists what *your* build has.",
  "footerNote": "Install with `curl -fsSL https://antigravity.google/cli/install.sh | bash` (macOS/Linux) or `irm https://antigravity.google/cli/install.ps1 | iex` (PowerShell). Gemini CLI itself continues for Gemini Code Assist Standard/Enterprise customers — see [geminicli.com](https://geminicli.com/docs/).",
  "sections": [
    {
      "id": "launch",
      "title": "Launch",
      "lede": "Everything you can type before you're in a session.",
      "sources": [
        "https://antigravity.google/docs/getting-started.md",
        "https://antigravity.google/docs/install.md",
        "https://antigravity.google/docs/cli/reference.md",
        "https://antigravity.google/docs/cli/headless.md",
        "https://antigravity.google/docs/cli/acp.md",
        "https://antigravity.google/docs/cli/conversations.md"
      ],
      "groups": [
        {
          "rows": [
            {
              "cmd": "curl -fsSL https://antigravity.google/cli/install.sh | bash",
              "desc": "Install on macOS/Linux. Windows: `irm https://antigravity.google/cli/install.ps1 | iex`."
            },
            {
              "cmd": "install.sh --skip-path | --skip-aliases",
              "desc": "Installer flags: don't touch your shell profile `PATH`, or don't purge legacy `agy`/`antigravity` aliases."
            },
            {
              "cmd": "agy --version",
              "desc": "Verify the install."
            },
            {
              "cmd": "agy",
              "desc": "Start the interactive TUI in the current directory."
            },
            {
              "cmd": "agy -i \"prompt\"",
              "desc": "Run an initial prompt, then stay interactive."
            },
            {
              "cmd": "agy -p \"prompt\"",
              "desc": "Headless: run once, print the response, exit. Aliases `--print`, `--prompt`."
            },
            {
              "cmd": "agy -c",
              "desc": "Continue the most recent conversation for this workspace. Long form `--continue`."
            },
            {
              "cmd": "agy --conversation <id>",
              "desc": "Resume a specific conversation by ID."
            },
            {
              "cmd": "agy models | agy agents",
              "desc": "Look up what `--model` and `--agent` take."
            },
            {
              "cmd": "agy acp",
              "desc": "Start an [Agent Client Protocol](https://agentclientprotocol.com) server over stdio for editors such as Zed and JetBrains. `agy acp --login` signs in first."
            }
          ]
        }
      ]
    },
    {
      "id": "flags",
      "title": "CLI flags",
      "sources": [
        "https://antigravity.google/docs/cli/reference.md",
        "https://antigravity.google/docs/cli/headless.md"
      ],
      "groups": [
        {
          "title": "Session shape",
          "rows": [
            {
              "cmd": "--mode accept-edits|auto|plan",
              "desc": "Start in an [execution mode](#approval). Omit for `default`."
            },
            {
              "cmd": "--add-dir <path>",
              "desc": "Add a directory to the workspace. Repeatable."
            },
            {
              "cmd": "--project <id|name> | --new-project",
              "desc": "Pick a project for the session, or create a new one."
            },
            {
              "cmd": "--remote-control",
              "desc": "Open a Remote Control connection for the session on startup."
            },
            {
              "cmd": "--remote-agent",
              "desc": "Run the session's conversations on Remote Agents; with `--project`, in that remote project."
            }
          ]
        },
        {
          "title": "Model & agent",
          "rows": [
            {
              "cmd": "--model <model>",
              "desc": "Model for this session (see `agy models`)."
            },
            {
              "cmd": "--effort <level>",
              "desc": "Reasoning effort, `low` through `max` depending on the model."
            },
            {
              "cmd": "--agent <name>",
              "desc": "Agent for this session (see `agy agents`)."
            }
          ]
        },
        {
          "title": "Safety",
          "rows": [
            {
              "cmd": "--sandbox",
              "desc": "Run in the terminal sandbox with OS containment. No effect where the sandbox is unavailable (v1.4.4+)."
            },
            {
              "cmd": "--dangerously-skip-permissions",
              "desc": "Auto-approve all tool permission requests without prompting.",
              "danger": true
            }
          ]
        },
        {
          "title": "Print mode & debugging",
          "rows": [
            {
              "cmd": "--output-format text|json|stream-json",
              "desc": "Shape of `stdout` in print mode. Default `text`."
            },
            {
              "cmd": "--input-format text|stream-json",
              "desc": "`stream-json` feeds prompts on stdin; requires `--output-format stream-json`."
            },
            {
              "cmd": "--json-schema <json|file>",
              "desc": "Enforce structured output in print mode."
            },
            {
              "cmd": "--print-timeout <dur>",
              "desc": "Time limit for print mode. `0` waits for the turn to finish."
            },
            {
              "cmd": "--disable-slash-commands",
              "desc": "In print mode, send prompts starting with `/` as typed instead of running commands or skills."
            },
            {
              "cmd": "--log-file <path>",
              "desc": "Override the CLI log file path."
            }
          ]
        }
      ]
    },
    {
      "id": "session",
      "title": "Session & history",
      "lede": "Typed inside the TUI. Conversations are scoped to the directory you launched `agy` from.",
      "sources": [
        "https://antigravity.google/docs/cli/reference.md",
        "https://antigravity.google/docs/cli/conversations.md",
        "https://antigravity.google/docs/cli/commands/resume.md"
      ],
      "groups": [
        {
          "title": "Conversation",
          "rows": [
            {
              "cmd": "/clear",
              "desc": "Clear the terminal and reset the conversation. Alias `/new`."
            },
            {
              "cmd": "/copy [n|btw]",
              "desc": "Copy the last response, the n-th most recent, or the latest `/btw` answer."
            },
            {
              "cmd": "/btw <query>",
              "desc": "Ask a side question in the background without interrupting the main conversation."
            },
            {
              "cmd": "/context",
              "desc": "Open the context usage visualization panel."
            },
            {
              "cmd": "/diff",
              "desc": "Interactive diff viewer for changes, turns, and commits."
            },
            {
              "cmd": "/usage",
              "desc": "Model quota usage. Alias `/quota`."
            },
            {
              "cmd": "/model [<model> <prompt>]",
              "desc": "Choose a model (persists). With a model and prompt, runs just that prompt on it."
            },
            {
              "cmd": "/effort [level]",
              "desc": "Set or inspect the reasoning effort level."
            }
          ]
        },
        {
          "title": "Resume, fork, rewind",
          "rows": [
            {
              "cmd": "/resume",
              "desc": "Conversation picker for this workspace. Aliases `/switch`, `/conversation`."
            },
            {
              "cmd": "/fork",
              "desc": "Clone the conversation so far into a new session. Alias `/branch`. Forks the thread, not your files."
            },
            {
              "cmd": "/rewind",
              "desc": "Roll the conversation back to an earlier message. Alias `/undo`."
            },
            {
              "cmd": "/rename <name>",
              "desc": "Rename the current session."
            }
          ]
        },
        {
          "title": "Long-running work",
          "rows": [
            {
              "cmd": "/goal <objective>",
              "desc": "Run autonomously until the goal is verified complete, without intermediate pauses."
            },
            {
              "cmd": "/schedule <when> <task>",
              "desc": "One-shot timer or recurring cron schedule that wakes the agent with an instruction."
            },
            {
              "cmd": "/tasks",
              "desc": "Task Manager panel for background shell execution logs."
            },
            {
              "cmd": "/boost <task>",
              "desc": "On-demand multi-agent deep reasoning loops."
            },
            {
              "cmd": "/teamwork <task>",
              "desc": "Collaborative multi-agent teams for long-horizon projects. Paid plans."
            }
          ]
        }
      ]
    },
    {
      "id": "approval",
      "title": "Execution modes & plan",
      "lede": "Cycle with <kbd>Shift+Tab</kbd>: `default` → `accept-edits` → `auto` → `plan`. Set at launch with `--mode` or persist as `agentMode`. Allow/ask/deny rules and `--dangerously-skip-permissions` take precedence in every mode.",
      "sources": [
        "https://antigravity.google/docs/cli/modes.md",
        "https://antigravity.google/docs/cli/reference.md"
      ],
      "groups": [
        {
          "rows": [
            {
              "cmd": "default",
              "desc": "Inline diff review before any file write; asks before terminal commands."
            },
            {
              "cmd": "accept-edits",
              "desc": "Auto-approves file creates and edits inside the workspace; still asks before commands. Subagents inherit it."
            },
            {
              "cmd": "auto",
              "desc": "Auto-approves edits, runs commands in the terminal sandbox, and auto-evaluates commands outside it. Needs the sandbox and a personal account; hidden where unavailable."
            },
            {
              "cmd": "plan",
              "desc": "Analyze and outline steps before writing code."
            }
          ]
        },
        {
          "title": "Planning & permissions",
          "rows": [
            {
              "cmd": "/plan [task]",
              "desc": "Explore, clarify requirements, and draft a reviewable Implementation Plan."
            },
            {
              "cmd": "/grill-me [task]",
              "desc": "Agent interviews you one question at a time, with a recommended answer for each, before starting."
            },
            {
              "cmd": "/artifact",
              "desc": "Open the Artifact Review panel. Also <kbd>Ctrl+R</kbd>."
            },
            {
              "cmd": "/permissions",
              "desc": "Interactive tool permissions manager."
            },
            {
              "cmd": "f",
              "desc": "On a pending edit, open the full-screen diff. <kbd>Esc</kbd> does not dismiss a pending edit."
            }
          ]
        }
      ]
    },
    {
      "id": "extend",
      "title": "Plugins, MCP, subagents & hooks",
      "sources": [
        "https://antigravity.google/docs/plugins.md",
        "https://antigravity.google/docs/mcp.md",
        "https://antigravity.google/docs/subagents.md",
        "https://antigravity.google/docs/hooks.md"
      ],
      "groups": [
        {
          "title": "Plugins",
          "rows": [
            {
              "cmd": "agy plugin install <name>",
              "desc": "Install from the official marketplace (`<name>@antigravity-plugins-official`). Needs a signed-in session."
            },
            {
              "cmd": "agy plugin install <github-url|path>",
              "desc": "Install from a GitHub repository or a local plugin directory."
            },
            {
              "cmd": "agy plugin import [gemini|claude]",
              "desc": "Convert extensions from `~/.gemini/extensions/` or plugins from `~/.claude/plugins/`."
            },
            {
              "cmd": "agy plugin list [--json]",
              "desc": "Installed plugins with state, version, source and component counts."
            },
            {
              "cmd": "/plugin",
              "desc": "Plugins Manager. Inline: `install`, `uninstall`, `enable`, `disable`, `list`. Alias `/plugins`."
            }
          ]
        },
        {
          "title": "MCP servers",
          "rows": [
            {
              "cmd": "/mcp",
              "desc": "MCP Manager overlay: live status, reload configs, connection logs."
            },
            {
              "cmd": "~/.gemini/config/mcp_config.json",
              "desc": "Global server definitions under `mcpServers`. Workspace: `.agents/mcp_config.json`."
            },
            {
              "cmd": "\"serverUrl\": \"https://…\"",
              "desc": "Remote server key (`url` also accepted). Gemini CLI's `httpUrl` isn't supported."
            }
          ]
        },
        {
          "title": "Subagents & hooks",
          "rows": [
            {
              "cmd": "/agents",
              "desc": "Agent Manager: switch custom agents and monitor background subagents."
            },
            {
              "cmd": "@<subagent> message",
              "desc": "Send a subagent new instructions directly, bypassing the parent."
            },
            {
              "cmd": "/hooks",
              "desc": "Browse the active hooks."
            },
            {
              "cmd": ".agents/hooks.json",
              "desc": "Workspace hooks. Global: `~/.gemini/config/hooks.json`. Hooks in `settings.json` aren't loaded."
            }
          ]
        }
      ]
    },
    {
      "id": "skills",
      "title": "Skills & rules",
      "lede": "Skills follow the [agentskills.io](https://agentskills.io/home) standard; each skill becomes a slash command (`deploy-staging` → `/deploy-staging`). Rules are cumulative constraints added to the prompt.",
      "sources": [
        "https://antigravity.google/docs/skills.md",
        "https://antigravity.google/docs/rules.md",
        "https://antigravity.google/docs/cli/reference.md"
      ],
      "groups": [
        {
          "title": "Skills",
          "rows": [
            {
              "cmd": "/skills",
              "desc": "Browse loaded local and global skills. `/skills reload` re-reads them from disk."
            },
            {
              "cmd": ".agents/skills/<skill>/SKILL.md",
              "desc": "Workspace skill, also read from parent folders up to the repo root. Legacy `.agent/skills` still works."
            },
            {
              "cmd": "~/.gemini/config/skills/<skill>/",
              "desc": "Global skills, shared with the Antigravity App. The CLI also reads `~/.gemini/antigravity-cli/skills/` and `~/.gemini/skills/`."
            },
            {
              "cmd": "/learn [instruction]",
              "desc": "Turn session corrections into persistent rules or skills via a reviewable proposal."
            }
          ]
        },
        {
          "title": "Rules",
          "rows": [
            {
              "cmd": "AGENTS.md | GEMINI.md",
              "desc": "Always-on, no frontmatter. Loaded from the workspace and each parent up to the repo root, also under `.agents/`."
            },
            {
              "cmd": ".agents/rules/*.md",
              "desc": "Modular rules with YAML frontmatter `trigger`: `always_on`, `model_decision`, `glob`, `manual`. Only immediate children are scanned. The CLI doesn't support rule mentions, so `manual` rules never load there."
            },
            {
              "cmd": "~/.gemini/GEMINI.md | ~/.gemini/AGENTS.md",
              "desc": "Global always-on rules. Modular global rules: `~/.gemini/config/rules/*.md`."
            },
            {
              "cmd": "@[label](path)",
              "desc": "Inside a rule file, inline another file's contents. Rule files are truncated at 24,000 bytes."
            }
          ]
        }
      ]
    },
    {
      "id": "config",
      "title": "Config & environment",
      "lede": "`/config` (alias `/settings`) edits `~/.gemini/antigravity-cli/settings.json` interactively.",
      "sources": [
        "https://antigravity.google/docs/cli/reference.md",
        "https://antigravity.google/docs/install.md",
        "https://antigravity.google/docs/cli/using.md"
      ],
      "groups": [
        {
          "title": "settings.json keys",
          "rows": [
            {
              "cmd": "\"agentMode\"",
              "desc": "Default execution mode: `\"\"`, `\"accept-edits\"`, `\"auto\"`, `\"plan\"`."
            },
            {
              "cmd": "\"toolPermission\"",
              "desc": "`request-review` (default), `proceed-in-sandbox`, `always-proceed`, or `strict`. Deny rules apply in every mode."
            },
            {
              "cmd": "\"permissions\"",
              "desc": "Allow, ask, and deny rules for the agent's tools."
            },
            {
              "cmd": "\"enableTerminalSandbox\"",
              "desc": "Contain every local command the agent runs. Default `false`."
            },
            {
              "cmd": "\"allowNonWorkspaceAccess\"",
              "desc": "Let the agent read and edit outside the workspace, subject to permissions."
            },
            {
              "cmd": "\"artifactReviewPolicy\"",
              "desc": "Whether the agent waits on artifact review: `asks-for-review`, `agent-decides`, `always-proceed`."
            },
            {
              "cmd": "\"queuedMessages\"",
              "desc": "`queue` holds a message until the turn ends; `send-immediately` interrupts."
            },
            {
              "cmd": "\"notifications\"",
              "desc": "Bell and desktop notification when the agent needs you or finishes."
            },
            {
              "cmd": "\"editorMode\": \"vim\"",
              "desc": "Modal prompt editing. `editor` picks the external program for <kbd>Ctrl+G</kbd>."
            },
            {
              "cmd": "\"$schema\"",
              "desc": "`https://antigravity.google/schemas/v1/settings.json` for editor autocomplete."
            }
          ]
        },
        {
          "title": "In-session & environment",
          "rows": [
            {
              "cmd": "/keybindings",
              "desc": "Open the Keyboard Shortcut Editor."
            },
            {
              "cmd": "/statusline | /title",
              "desc": "Customize the status bar, or toggle terminal title updates."
            },
            {
              "cmd": "/logout",
              "desc": "Disconnect and purge tokens from the OS keyring."
            },
            {
              "cmd": "GEMINI_API_KEY",
              "desc": "Used only with `\"modelProvider\": \"gemini\"` in settings. `GOOGLE_API_KEY` and `.env` files are ignored."
            },
            {
              "cmd": "GOOGLE_GEMINI_BASE_URL",
              "desc": "Send model requests to a different Gemini-compatible endpoint."
            }
          ]
        }
      ]
    },
    {
      "id": "keys",
      "title": "Keyboard & input",
      "lede": "Rebind anything in `~/.gemini/antigravity-cli/keybindings.json` (delete it to reset).",
      "sources": [
        "https://antigravity.google/docs/cli/reference.md",
        "https://antigravity.google/docs/cli/using.md"
      ],
      "groups": [
        {
          "title": "Prompt",
          "rows": [
            {
              "cmd": "Shift+Enter / Ctrl+J",
              "desc": "Newline without submitting."
            },
            {
              "cmd": "Shift+Tab",
              "desc": "Cycle execution modes."
            },
            {
              "cmd": "Ctrl+G",
              "desc": "Compose the prompt in `$EDITOR`."
            },
            {
              "cmd": "Ctrl+V",
              "desc": "Paste images or clipboard blocks."
            },
            {
              "cmd": "Ctrl+O",
              "desc": "Expand or collapse detailed tool reasoning output."
            },
            {
              "cmd": "Ctrl+R",
              "desc": "Artifact Review panel."
            },
            {
              "cmd": "Ctrl+_ / Ctrl+Shift+Z",
              "desc": "Undo / redo an edit."
            },
            {
              "cmd": "F5",
              "desc": "Start or stop voice dictation."
            }
          ]
        },
        {
          "title": "Control",
          "rows": [
            {
              "cmd": "Esc",
              "desc": "Close panels, halt the stream, or clear an empty prompt."
            },
            {
              "cmd": "Ctrl+C",
              "desc": "Exit (confirms if the agent is working)."
            },
            {
              "cmd": "Ctrl+D",
              "desc": "Exit on an empty prompt; forward-delete otherwise."
            },
            {
              "cmd": "Ctrl+L",
              "desc": "Clear and redraw the terminal."
            },
            {
              "cmd": "Alt+J",
              "desc": "Jump to the next subagent awaiting confirmation."
            },
            {
              "cmd": "Ctrl+K",
              "desc": "Approve the pending subagent action without switching panels."
            },
            {
              "cmd": "y / n",
              "desc": "Approve or reject the proposed tool, command, or artifact."
            },
            {
              "cmd": "A",
              "desc": "In the Review panel, approve all artifacts."
            }
          ]
        }
      ]
    },
    {
      "id": "headless",
      "title": "Headless & scripting",
      "lede": "`-p` runs once and exits. The response goes to `stdout`; errors, auth and progress go to `stderr`. Uses cached credentials — sign in interactively first, or CI exits with `authentication required`.",
      "sources": [
        "https://antigravity.google/docs/cli/headless.md"
      ],
      "groups": [
        {
          "rows": [
            {
              "cmd": "agy -p \"query\" --output-format json",
              "desc": "One JSON envelope: `conversation_id`, `status`, `response`, `usage`, …"
            },
            {
              "cmd": "agy -p \"query\" --output-format stream-json",
              "desc": "NDJSON: one `init`, `step_update` events, one `result`."
            },
            {
              "cmd": "agy -p \"query\" --json-schema '<schema>'",
              "desc": "Parsed result lands in `structured_output`."
            },
            {
              "cmd": "agy -p \"more\" --continue",
              "desc": "Headless runs are stateless; `-c` or `--conversation <id>` picks up prior context."
            },
            {
              "cmd": "agy --input-format stream-json --output-format stream-json",
              "desc": "One long-lived process; write `{\"event\":\"user\",\"message\":{\"content\":\"…\"}}` lines to stdin, one `result` per turn."
            },
            {
              "cmd": "exit codes",
              "desc": "`0` on success; non-zero with the reason on `stderr`. JSON modes also set `status` and `error`."
            }
          ]
        }
      ]
    },
    {
      "id": "files",
      "title": "File map",
      "navLabel": "Files",
      "columns": true,
      "sources": [
        "https://antigravity.google/docs/cli/using.md",
        "https://antigravity.google/docs/skills.md",
        "https://antigravity.google/docs/rules.md",
        "https://antigravity.google/docs/mcp.md",
        "https://antigravity.google/docs/hooks.md",
        "https://antigravity.google/docs/subagents.md",
        "https://antigravity.google/docs/cli/commands/resume.md"
      ],
      "groups": [
        {
          "rows": [
            {
              "cmd": "~/.gemini/antigravity-cli/settings.json",
              "desc": "CLI settings."
            },
            {
              "cmd": "~/.gemini/antigravity-cli/keybindings.json",
              "desc": "Custom key bindings."
            },
            {
              "cmd": "~/.gemini/antigravity-cli/cache/last_conversations.json",
              "desc": "Workspace → last conversation map that `-c` reads."
            },
            {
              "cmd": "~/.gemini/config/",
              "desc": "Global `mcp_config.json`, `hooks.json`, `skills/`, `agents/`, `rules/`, `plugins/`."
            }
          ]
        },
        {
          "rows": [
            {
              "cmd": "AGENTS.md · GEMINI.md",
              "desc": "Workspace rules, always on."
            },
            {
              "cmd": ".agents/rules/ · .agents/skills/",
              "desc": "Workspace rules and skills."
            },
            {
              "cmd": ".agents/agents/<name>.md",
              "desc": "Workspace subagent (or `<name>/agent.md`)."
            },
            {
              "cmd": ".agents/mcp_config.json · .agents/hooks.json",
              "desc": "Workspace MCP servers and hooks."
            }
          ]
        }
      ]
    },
    {
      "id": "migrate",
      "title": "Coming from Gemini CLI",
      "navLabel": "Migrate",
      "lede": "On first launch `agy` detects Gemini CLI config and offers a checklist to convert extensions and settings, and moves session tokens to the OS keyring. Parity is partial.",
      "sources": [
        "https://antigravity.google/docs/cli/gcli-migration.md",
        "https://antigravity.google/docs/mcp.md"
      ],
      "groups": [
        {
          "rows": [
            {
              "cmd": "gemini → agy",
              "desc": "The binary."
            },
            {
              "cmd": "agy plugin import gemini",
              "desc": "Convert extensions to plugins; legacy commands become skills, MCP servers move to `mcp_config.json`."
            },
            {
              "cmd": ".gemini/skills/ → .agents/skills/",
              "desc": "Workspace skills must be moved by hand. `~/.gemini/skills/` still loads."
            },
            {
              "cmd": "~/.gemini/settings.json → ~/.gemini/config/mcp_config.json",
              "desc": "MCP servers leave the settings file. Workspace: `.agents/mcp_config.json`."
            },
            {
              "cmd": "httpUrl → serverUrl",
              "desc": "Remote MCP server key. `url` still works."
            },
            {
              "cmd": "GEMINI.md · AGENTS.md",
              "desc": "Unchanged — workspace and `~/.gemini/GEMINI.md` context still loads."
            }
          ]
        }
      ]
    }
  ]
}