Antigravity CLI cheat sheet

Every command, flag and slash command for agy — Google Antigravity's terminal agent — the `agy` TUI counterpart to the Antigravity IDE, same harness, Google-login auth. 12+ commands, verified July 2026.

agy is the terminal surface of Google Antigravity — it shares the agent harness and settings with the Antigravity IDE. Auth is Google login (no API key); the token lives in your OS keyring.

Install

curl -fsSL https://antigravity.google/cli/install.sh | bash    # macOS / Linux
irm https://antigravity.google/cli/install.ps1 | iex           # Windows (PowerShell)
# binary: agy → ~/.local/bin/agy  ·  self-updates in the background

Start & run

agy                              # launch the TUI (first run: setup + Google login)
agy -p "<prompt>" --cwd $(pwd)   # one-shot, non-interactive (scripts / git hooks)
agy --mode=plan                  # start in plan mode (outline before editing)
agy --mode=accept-edits          # auto-approve file writes
agy --sandbox --model="Gemini 3.5 Flash"

Key flags

Flag	What it does
`-p "<prompt>"`	One-shot non-interactive run, then exit
`--cwd <path>`	Working directory for the run
`--mode=<default\|accept-edits\|plan>`	Execution mode (note: `--mode`, not `--permission-mode`)
`--model="<name>"`	Reasoning model for the session
`--sandbox`	Run with the OS terminal sandbox on
`--dangerously-skip-permissions`	Bypass tool-permission prompts

In-session slash commands

Command	What it does
`/help` (`?`) · `/clear` (`/new`)	Help · reset context
`/model` · `/config` (`/settings`)	Default model · settings editor
`/agents` · `/artifact` · `/tasks`	Agent Manager · artifact review · background tasks
`/mcp` · `/permissions` · `/hooks`	MCP · tool permissions · hooks
`/diff` · `/rewind` (`/undo`) · `/resume`	Diff viewer · roll back · load a session
`/skills` · `/context` · `/usage` (`/quota`)	Skills · context usage · quota

Keys: Shift+Tab cycles default → accept-edits → plan · @ file paths · ! shell command · Ctrl+K fast-approve a subagent.

Config

// ~/.gemini/antigravity-cli/settings.json  (sparse — only non-defaults; /config edits live)
// ~/.gemini/antigravity-cli/keybindings.json
{ "agentMode": "accept-edits", "toolPermission": "request-review", "enableTerminalSandbox": true }
// auth: Google login → OS keyring (Keychain / Secret Service / Credential Manager). No API-key env vars.

Common one-liners

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy                                          # interactive TUI in the current project
agy -p "Review this git diff and draft a conventional commit message" --cwd $(pwd)
agy --mode=plan                              # outline before editing

More CLI cheat sheets

Stop memorizing flags

Run Antigravity CLI — and every other agent — from one app

TheVibeFather orchestrates Antigravity CLI alongside every other coding CLI in one native macOS app. Bring the models you already pay for; keep your keys.

Get started See how it works