Skip to main content
Toolsbase.

Reference · Reference

Google Antigravity CLI (agy) Cheat Sheet

Search and one-click copy commands for Google's AI coding CLI, Antigravity CLI (agy). The successor to Gemini CLI — covering subcommands, flags, slash commands, shortcuts, and settings.

Last updated:

Version: v1.1.x (verified on v1.1.14 / 2026-08-19) | Updated August 2026

How to use

Expand how to use
  1. 1

    Search commands

    Type a keyword to filter across command names, flags, descriptions, and examples at once.

  2. 2

    Filter by category

    Switch between CLI commands, flags, slash commands, shortcuts, and settings to quickly find what you need.

  3. 3

    One-click copy

    Use the copy button to copy a command to your clipboard and paste it straight into your terminal or an Antigravity CLI session.

Latest updates

Recent notable updates to Antigravity CLI. See the bottom of the page for the full history.

v1.1.14 (August 18, 2026)

  • Latest release as of 2026-08-18 (covers changes through v1.1.6-v1.1.14). Commands, flags, and settings were re-verified against the GitHub CHANGELOG
  • Added the --output-format flag (text/json/stream-json) and the --json-schema flag to print mode for strongly-typed, machine-readable NDJSON output (v1.1.8); the models and agents subcommands also support --output-format (v1.1.12)
  • Added a Vim editing mode: set editorMode in settings.json (default: default) to vim for Normal/Insert/Visual/Visual Line modes with the major motions (v1.1.11)

v1.1.5 (July 2026)

  • Latest release as of 2026-07-21 (covers changes through v1.1.1-v1.1.5). Commands, flags, and shortcuts on this page were re-verified against the GitHub release notes
  • Added /effort and the --effort launch flag to view and change the model's reasoning effort (v1.1.5)
  • Added /codesearch (aliases /cs, /search) for interactive regex-based code search across the workspace (v1.1.3)
See full update history

CLI Commands

agy

Start the interactive Antigravity CLI TUI session in the current directory

Examples

agy
Start an interactive session

agy "prompt"

Start an interactive session with an initial prompt

Examples

agy "Explain the structure of this repo"
Start with an initial instruction

agy -p "prompt"

Run a single prompt non-interactively and print the response (for CI and scripts)

Notes

  • --print-timeout sets the wait timeout (default 5m)

Examples

agy -p "Fix the failing tests"
Run non-interactively and print the result

agy run

Run the agent via the run subcommand

agy models

List available models (added in v1.0.5)

Examples

agy models
List supported models

agy agents

List available custom agents (added in v1.1.1, alias agy agent)

Examples

agy agents
List custom agents

agy plugin install

Install a plugin

agy plugin uninstall

Uninstall a plugin

agy plugin list

List installed plugins

agy plugin enable

Enable an installed plugin

agy plugin disable

Disable a plugin without deleting its assets

Examples

agy plugin disable my-plugin
Disable the specified plugin

agy plugin import gemini

Convert and migrate Gemini CLI extensions to Antigravity plugins. Use this when switching from Gemini CLI

Examples

agy plugin import gemini
Migrate Gemini CLI extensions in bulk

agy changelog

Show the changelog and release notes (added on 2026-06-04)

Examples

agy changelog
Show the release notes

agy install

Configure environment PATH and shell settings (post-install setup)

Notes

  • --skip-aliases preserves existing agy / antigravity aliases
  • --skip-path does not modify the shell profile PATH

agy help

Show help for subcommands

CLI Flags

--model

Set the model used for the current CLI session

Examples

agy --model gemini-3-pro
Start with a specific model

--effort

Select the model's reasoning-effort variant at launch (added in v1.1.5)

--mode

Set the agent execution mode at startup (default / accept-edits / plan). Added in v1.1.0

Examples

agy --mode plan
Start in plan mode

--agent

Select a custom agent to run at launch (added in v1.1.1)

Examples

agy --agent my-agent
Start with the specified custom agent

-p, --print

Run a single prompt non-interactively and print the response (alias --prompt)

--output-format

Launch flag that sets the output format for print mode (-p): text (default), json, or stream-json (a strongly-typed NDJSON event stream). Added in v1.1.8; extended to the models and agents subcommands in v1.1.12

--json-schema

Launch flag that enforces a custom JSON schema on print-mode JSON output. Accepts an inline schema string or a path to a schema file. Added in v1.1.8

--disable-slash-commands

Launch flag that disables slash-command and skill expansion in print mode (the prompt is always treated literally). Added in v1.1.9

-i, --prompt-interactive

Run an initial prompt and then continue the interactive session

-c, --continue

Continue the most recent conversation (alias -c)

--conversation

Resume a previous conversation by ID

--add-dir

Add a directory to the workspace (repeatable)

--project

Explicitly set the project to use at launch

Examples

agy --project my-project
Launch with the specified project

--new-project

Create a new project at launch

Examples

agy --new-project my-project
Create and launch a new project

--sandbox

Run in a sandbox with terminal restrictions enabled

--dangerously-skip-permissions

Auto-approve all tool permission requests (use with caution; safety checks are skipped)

Examples

agy --dangerously-skip-permissions
Start without permission prompts (use with caution)

--print-timeout

Set the wait timeout for print mode (default 5m)

--log-file

Override the CLI log file path

--skip-aliases

Preserve existing agy / antigravity aliases during install

--skip-path

Do not modify the shell profile PATH during install

Slash Commands

/

Open the command menu; typing it in the prompt shows slash command suggestions

?

Display help (when the prompt is empty; alias /help)

/usage

Display model quota usage (alias /quota)

/context

Open the context usage visualization panel (scrollable and sized to the terminal)

/add-dir

Add a directory to the active workspace

/open

Open a path in the default system editor

/diff

Show unified diffs of modified files

/codesearch

Search code across the workspace interactively (added in v1.1.3, aliases /cs, /search)

Notes

  • Queries are interpreted as regex by default; -F / --literal switches to exact matching
  • f: or file: globs include or exclude paths

Examples

/codesearch
Open interactive code search

/clear

Clear the terminal and reset the conversation context

/resume

Load and resume previous conversation threads (aliases /switch, /conversation)

/rewind

Roll back conversation history to an earlier point (alias /undo)

/fork

Branch the current session to create a parallel session (alias /branch)

/rename

Rename the active thread

/copy

Copy the most recent agent response to the system clipboard. Add a number like /copy 2 to copy the second most recent response (index argument added in v1.1.6)

/config

Open the interactive settings editor (alias /settings)

/permissions

Switch the permission preset (global permission behavior)

/model

Switch the reasoning model mid-session

/effort

View and change the current model's reasoning effort (added in v1.1.5)

Notes

  • Direct form /effort level switches without opening the picker

Examples

/effort
Open the reasoning-effort picker

/plan

Enable plan mode. In v1.1.0 this replaced the legacy /planning (and /fast was removed)

/agents

Open the Agent Manager panel to review subagent approvals and activity

/tasks

Open the Task Manager panel to view shell execution logs

/skills

Browse loaded local and global Agent Skills

/mcp

Open the MCP (Model Context Protocol) server manager

/hooks

Browse active pre-flight and post-format hooks

/btw

Ask a side question without interrupting the main conversation

/keybindings

Open the keyboard shortcut editor to customize key bindings

/statusline

Customize the status bar (status line)

/title

Toggle terminal window title updates on or off

/credits

Open the credits panel to check your remaining AI credits and usage. You can also buy more credits or upgrade your plan from here

/exit

Close the CLI

/logout

Disconnect the account and remove saved authentication tokens

Shortcuts

Enter
Submit the prompt or confirm the selected menu item
Shift+Enter/Ctrl+J
Insert a newline without submitting
Alt+Enter
Insert a newline while editing the prompt
Tab
Confirm the highlighted slash-command autofill
Shift+Tab
Cycle the agent execution mode (default → accept-edits → plan). Added in v1.1.0
Esc
Close panels, stop streams, or clear an empty prompt
Ctrl+C
First press cancels the active streaming agent operation; pressing it again on an empty prompt exits the CLI
Ctrl+D
Forward-deletes when the prompt has text; exits the TUI session when the prompt is empty
Ctrl+L
Clear the visual terminal buffer
Ctrl+V
Paste text, clipboard blocks, or terminal media
Ctrl+G
Open the default shell editor to compose the prompt
Ctrl+O
Toggle the detailed tool reasoning output on or off
Ctrl+R
Open the Artifact Review panel
Alt+J
Switch focus to the next subagent awaiting confirmation
Ctrl+K
Approve the pending subagent action from the fast-path alert
Ctrl+A
Move the prompt cursor to the start of the line
Ctrl+E
Move the prompt cursor to the end of the line
Ctrl+Z
Undo the last text edit
Ctrl+Shift+Z
Redo the last undone text edit
Up/Down
Navigate menu selections up and down
PgUp/Shift+Up
Scroll the active viewport up one page
PgDn/Shift+Down
Scroll the active viewport down one page
!
Prefix with "!" to run a shell command directly (e.g. !npm test)
y
Approve the proposed tool, command, or artifact
n
Reject the proposed tool, command, or artifact
A
Approve all generated artifacts in the Review panel
f
In request-review mode's diff preview, review and accept or reject individual code changes. Added in v1.1.0
t
Open the heading outline in the artifact viewer. Added in v1.1.12

Settings

curl -fsSL https://antigravity.google/cli/install.sh | bash

Install command for macOS/Linux. The executable is placed at ~/.local/bin/agy

Examples

curl -fsSL https://antigravity.google/cli/install.sh | bash
Install on macOS/Linux

irm https://antigravity.google/cli/install.ps1 | iex

Install command for Windows (PowerShell or CMD)

Examples

irm https://antigravity.google/cli/install.ps1 | iex
Install via PowerShell
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
Install via Command Prompt (CMD)

rm ~/.local/bin/agy

Uninstall steps for macOS/Linux. There is no dedicated uninstall command, so delete the installed binary directly

Examples

rm ~/.local/bin/agy
Delete the installed binary
rm -rf ~/.gemini/antigravity-cli
Full cleanup including the settings directory — this cannot be undone (also remove the PATH and alias lines that agy install added to your shell profile)

Remove-Item "$env:LOCALAPPDATA\agy\bin\agy.exe"

Uninstall steps for Windows: delete agy.exe under %LOCALAPPDATA%\agy\bin

Examples

Remove-Item "$env:LOCALAPPDATA\agy\bin\agy.exe"
Delete the binary with PowerShell
del "%LOCALAPPDATA%\agy\bin\agy.exe"
Delete the binary with Command Prompt (CMD)

~/.gemini/antigravity-cli/settings.json

User settings file that defines color theme, permission behavior, and more

~/.gemini/antigravity-cli/keybindings.json

Key bindings file, editable via /keybindings; deleting it restores defaults

toolPermission

Set the tool approval behavior (default request-review)

request-review / strict / ...

Permission presets: request-review (default), proceed-in-sandbox (auto inside sandbox), always-proceed (no prompts), strict (prompt for all non-read tools)

artifactReviewPolicy

Set the code (artifact) review flow (default asks-for-review)

colorScheme

Set the color theme (default terminal)

altScreenMode

Set the screen buffer mode (default default). "default" renders inline in your terminal; "always" uses a flicker-free alternate screen buffer

copyOnSelect

Auto-copies selected text to the clipboard in altscreen mode (default on). Toggleable from /settings. Added in v1.1.8

editor

Set the external editor used for prompt editing (e.g. Ctrl+G) (default auto, which follows $EDITOR)

editorMode

Sets the editing mode inside the CLI prompt (default: default). Set it to vim for Normal/Insert/Visual/Visual Line modes with the major Vim motions and operators. Added in v1.1.11

verbosity

Set the output detail level (default high; use low for less output)

runningLightSpeed

Set the speed of the progress animation shown while the agent is working (default medium)

notifications

Enable desktop and terminal bell notifications on task completion (default false)

showTips

Show helpful agent tips above the prompt panel (default true)

showFeedbackSurvey

Show periodic quality feedback surveys on task completion (default true)

enableTerminalSandbox

Enable command sandboxing (default false)

allowNonWorkspaceAccess

Allow file access outside the workspace root (default false)

enableTelemetry

Enable collection of metrics and crash logs (default true)

modelProvider

Switches the model provider. Set it to gemini with the GEMINI_API_KEY environment variable to use the Gemini API directly without signing in (custom endpoint via GOOGLE_GEMINI_BASE_URL). Added in v1.1.13

~/.gemini/config/mcp_config.json

Path to the global MCP server configuration file

.agents/mcp_config.json

Path to the per-workspace MCP server configuration file

GEMINI.md

Workspace context instruction file (from Gemini CLI) for project-specific instructions

AGENTS.md

Workspace context instruction file; a standard format shareable across multiple AI agents

Version history

The Antigravity CLI version and key changes used to verify the data on this page.

v1.1.14 (August 18, 2026)

View official docs

  • Latest release as of 2026-08-18 (covers changes through v1.1.6-v1.1.14). Commands, flags, and settings were re-verified against the GitHub CHANGELOG
  • Added the --output-format flag (text/json/stream-json) and the --json-schema flag to print mode for strongly-typed, machine-readable NDJSON output (v1.1.8); the models and agents subcommands also support --output-format (v1.1.12)
  • Added a Vim editing mode: set editorMode in settings.json (default: default) to vim for Normal/Insert/Visual/Visual Line modes with the major motions (v1.1.11)
  • Added the copyOnSelect setting (auto-copy on selection, default on) and the modelProvider setting (set to gemini with GEMINI_API_KEY for direct Gemini API access) to settings.json (v1.1.8 / v1.1.13)
  • Added an index argument to /copy (v1.1.6), a heading outline opened with t in the artifact viewer (v1.1.12), and non-interactive answers for read-only slash commands in print mode (v1.1.9-v1.1.12). The delete-conversation key in the /resume picker moved from Ctrl+Delete to F4 (v1.1.13)
v1.1.5 (July 2026)

View official docs

  • Latest release as of 2026-07-21 (covers changes through v1.1.1-v1.1.5). Commands, flags, and shortcuts on this page were re-verified against the GitHub release notes
  • Added /effort and the --effort launch flag to view and change the model's reasoning effort (v1.1.5)
  • Added /codesearch (aliases /cs, /search) for interactive regex-based code search across the workspace (v1.1.3)
  • Added the --agent launch flag and the agy agents subcommand to select and list custom agents (v1.1.1)
  • Multiple leading slash commands can now be stacked in a single prompt (v1.1.4)
v1.1.0 (July 2026)

View official docs

  • Latest stable release (2026-07-08). Agent execution mode cycling (default → accept-edits → plan) is now publicly available and can be switched with shift+tab
  • Slash commands streamlined: /plan replaces the legacy /planning and /fast was removed. The new --mode launch flag sets the execution mode directly
  • request-review is now the default mode: it pauses before file writes to show a line-level diff preview, and the f shortcut accepts or rejects individual changes
  • Added an Agent Mode option to the /settings panel to persist a default execution mode; footer keybinding hints now respect custom keybindings.json
  • Note: the official docs had not yet reflected 1.1.0 on this date, so this entry was verified against the GitHub CHANGELOG / release notes
v1.0.16 (July 2026)

View official docs

  • Latest release as of 2026-07-02 (covers changes through v1.0.11-v1.0.16). Every command, flag, shortcut, and setting on this page was re-checked against the official docs (antigravity.google/docs/cli/*) and GitHub Releases
  • Added the --project / --new-project launch flags (v1.0.12), the agy plugin disable subcommand, and the /credits slash command
  • Added altScreenMode, editor, runningLightSpeed, notifications, showTips, and showFeedbackSurvey to settings.json
  • Ctrl+C now cancels the active agent operation on the first press and exits the CLI on a double press; Ctrl+D forward-deletes when the prompt has text (v1.0.11)
v1.0.10 (June 2026)

View official docs

  • Latest release as of 2026-06-19. All commands, flags, and shortcuts on this page were verified against the official docs and GitHub for this version
  • The agy models subcommand lists supported models (added in v1.0.5)
  • The agy changelog command shows release notes (added on 2026-06-04)
Initial release (May 2026)

View official docs

  • Announced by Google on 2026-05-19 as the successor to Gemini CLI. The legacy Gemini CLI was shut down on 2026-06-18
  • agy plugin import gemini migrates Gemini CLI extensions to Antigravity plugins

About the Google Antigravity CLI command reference

Antigravity CLI (command name agy) is Google's terminal AI coding agent. Announced in May 2026 as the successor to Gemini CLI, it replaced the legacy Gemini CLI, which was shut down on June 18, 2026. It brings multi-step reasoning, multi-file editing, tool calling, and persistent history to the terminal, and you can migrate Gemini CLI extensions with agy plugin import gemini. This page is a cheat sheet covering CLI subcommands, flags, slash commands, keyboard shortcuts, and settings, verified against the GitHub release and official docs for v1.1.5 (July 2026). It covers the CLI (agy), not the Antigravity IDE.

Key features

  • Covers five categories: CLI subcommands, flags, slash commands, shortcuts, and settings
  • Full-text search across command names, descriptions, and examples
  • Category filters to switch between terminal commands and in-session actions
  • One-click copy to paste commands straight away
  • Guidance for migrating from Gemini CLI (agy plugin import gemini)

Use cases

  • Checking command equivalents when migrating from Gemini CLI to Antigravity CLI (agy)
  • Reviewing options for non-interactive runs with agy -p (CI and scripts)
  • Searching slash commands (/agents, /mcp, etc.) and shortcuts during a TUI session
  • A reference for the key settings.json keys and permission presets

Frequently asked questions

What is the Antigravity CLI (agy)?

It is the command-line interface for Google's terminal AI coding agent. The command name is agy, and it runs multi-step reasoning, multi-file editing, and tool calling from the terminal. It supports both an interactive TUI and non-interactive runs via agy -p (for CI and automation).

How does it relate to Gemini CLI? Do I need to migrate?

Antigravity CLI is the successor to Gemini CLI. Google announced the replacement on May 19, 2026, and the legacy Gemini CLI was shut down on June 18, 2026. Settings live under ~/.gemini/antigravity-cli/, and the agy plugin import gemini command migrates Gemini CLI extensions to Antigravity plugins.

Are the Antigravity IDE and the Antigravity CLI different?

Yes. The Antigravity IDE is an editor (GUI) product, while the Antigravity CLI (agy) is a command-line tool that runs in the terminal. This page covers the CLI (agy) commands, flags, slash commands, and settings.

How do I install the Antigravity CLI?

On macOS/Linux run curl -fsSL https://antigravity.google/cli/install.sh | bash, and on Windows (PowerShell) run irm https://antigravity.google/cli/install.ps1 | iex. After installing, you can run agy install to configure PATH and shell settings.

What permission presets are available?

There are four: request-review (default, for most work), proceed-in-sandbox (auto-proceed inside a sandbox), always-proceed (no prompts, for controlled workspaces only), and strict (prompt for all non-read tools). You can switch them with /permissions.

How do I use slash commands?

During a TUI session, type "/" in the prompt to open the command menu. Commands include /agents (manage agents), /mcp (manage MCP servers), /diff (show diffs), and /rewind (roll back), and you can show help with "?".

Which version does this cheat sheet cover?

It covers Antigravity CLI v1.1.x (verified on v1.1.14 / August 19, 2026). The listed commands have been cross-checked against the official docs (antigravity.google) and GitHub, with the v1.1.x changes sourced from the GitHub CHANGELOG / release notes.

Can I customize the keyboard shortcuts?

Yes. The shortcuts listed here are the defaults, and you can change them via the /keybindings command or the keybindings.json file. To reset, delete keybindings.json to restore the defaults.

How do I uninstall the Antigravity CLI (agy)?

There is no dedicated uninstall command (as of v1.1.14). On macOS/Linux, delete the installed binary at ~/.local/bin/agy; on Windows, delete agy.exe under %LOCALAPPDATA%\agy\bin. For a full cleanup, also remove the settings directory ~/.gemini/antigravity-cli/ and the PATH and alias lines that agy install added to your shell profile.

How do I skip permission prompts?

There are two ways. For a whole session, switch the permission preset to always-proceed (run without prompts) via /permissions. At startup, the agy --dangerously-skip-permissions flag auto-approves all tool permission requests. Both skip safety checks, so limit them to controlled workspaces or sandboxed runs (the proceed-in-sandbox preset).

How do I check the Antigravity CLI changelog?

Run the agy changelog command to show the release notes in your terminal (added on June 4, 2026). You can also review each version's changes on the GitHub Releases page. The version history section on this page summarizes the main changes of the versions used to verify this data.

Related Guide Articles

AI Coding CLI Comparison 2026: Codex vs Claude Code vs Cursor vs Cline vs Grok Build & MoreGemini CLI Is Shut Down: Migration Guide to Antigravity CLI (with Command Mapping)

Related Tools

Codex CLI CommandsClaude Code CommandsGrok Build CommandsClaude Code Features Guide