This Antigravity CLI cheatsheet is a quick reference for agy shell commands, launch and headless flags, slash commands, keyboard shortcuts, settings, permissions, MCP configuration, and Gemini CLI migration.
Use the quick reference for common actions, then use the grouped tables below when you need an exact command, argument, shortcut, config key, or file path.
Updated on October 13, 2026.
Antigravity CLI Cheatsheet
Quick reference
| Command | Task |
|---|---|
agy | Start CLI |
/ | Open slash commands |
/help or ? on an empty prompt | Help |
/codesearch, /cs, /search | Search code |
/config, /settings | Settings |
/permissions | Permissions |
/model or /model <name> | Choose model |
/model <name> <prompt> | Ask another model once |
/effort, /effort <level>, --effort <level> | Reasoning effort |
/plan <task> or Shift+Tab to plan mode | Plan before editing |
/goal <task> | Autonomous goal |
/boost <task> | Deep reasoning |
/teamwork-preview <task> | Agent team |
/voice, /record, F5 | Voice dictation |
/skills reload | Reload skills and slash commands |
--remote-control, /remote-control | Connect to the current session remotely |
@<subagent> <message> | Message a subagent directly |
/diff or Ctrl+R | Review changes |
/copy btw | Copy the active /btw response |
/resume | Resume conversation |
/rewind, /undo | Rewind conversation |
/fork, /branch | Fork conversation |
/add-dir <path> | Add workspace folder |
!<command> | Run shell command |
agy -p "<prompt>" | Run one headless prompt |
--output-format json | JSON output |
--input-format stream-json --output-format stream-json | Streaming input/output |
agy models | List models |
agy agents | List custom agents |
agy remote-control ... | Remote Control service |
agy plugin ... | Plugins |
/mcp or agy mcp ... | MCP servers |
/logout | Log out |
/exit, /quit | Exit |
Command syntax
| Syntax | Meaning |
|---|---|
agy ... | Shell command or subcommand. |
--flag | Launch or headless command-line option. |
/command | Interactive TUI slash command. |
@ | Open file path suggestions; use @<subagent> <message> to message a subagent. |
!command | Run a terminal command directly. |
<value> | Required argument. |
[value] | Optional argument. |
Shell commands and subcommands
| Command | Use |
|---|---|
agy | Start an interactive Antigravity CLI session. |
agy "<prompt>" | Start the CLI with an initial prompt. |
agy models | List available model slugs. |
agy agents | List available custom agents. |
agy changelog | Show the CLI changelog. |
agy mic-serve | Forward a local microphone to a remote CLI voice session. |
agy remote-control start [--name <label>] [--session] | Register and start the Remote Control background service. Use --name for a machine label or --session to limit it to the active login session. |
agy remote-control status | Show Remote Control service status. |
agy remote-control stop | Stop and unregister the Remote Control background service. |
agy plugin list | List all installed plugins with version and enabled state; add --json for machine-readable output. |
agy plugin install <path> | Install a local or remote plugin package. |
agy plugin disable <name> | Disable a plugin. |
agy plugin enable <name> | Enable a plugin. |
agy plugin uninstall <name> | Remove a plugin. |
agy plugin import gemini | Convert Gemini CLI extensions to Antigravity plugins. |
agy mcp list | List user-level MCP servers. |
agy mcp enable <name> | Enable an MCP server. |
agy mcp disable <name> | Disable an MCP server. |
agy mcp remove <name> | Remove an MCP server. |
agy plugin install <plugin-name>@antigravity-plugins-official | Install a plugin from the official marketplace. |
Add MCP servers
agy mcp add <name> --type stdio --env KEY=value -- <command> [args]
agy mcp add <name> --type http --header "Header: value" <url>Launch and headless flags
| Flag and default | Use |
|---|---|
-p, --print, --prompt | Run one prompt non-interactively and print the response. |
--output-formatDefault: text | Return text, json, or stream-json. |
--input-formatDefault: text | Read text or stream-json prompts from stdin. |
--json-schema | Use an inline JSON schema or schema file with an object root. Bare type names and non-object roots fail at startup with exit code 1. |
--model <slug> | Use a model returned by agy models. Base model names use the default thinking level when --effort is omitted. |
--effort <level> | Set a reasoning effort supported by the selected model. |
--agent <name> | Run with a custom agent returned by agy agents. |
--remote-control | Start a session-scoped Remote Control connection. |
--continue, -cDefault: false | Continue the most recent conversation. |
--conversation <id> | Resume a conversation by ID. |
--print-timeout <duration>Default: unlimited | Set a maximum headless wait. If it expires mid-turn, the CLI returns available partial output and writes a warning to stderr. |
--sandboxDefault: false | Enable terminal sandbox restrictions for the run. |
--dangerously-skip-permissionsDefault: false | Skip tool permission prompts. Plans and other artifacts still follow artifactReviewPolicy. |
--mode <mode>Default: Configured mode | Start in default, accept-edits, or plan. |
--project <project> | Open an existing project by name or ID. |
--new-project <name> | Create a project. |
--disable-slash-commandsDefault: false | Keep slash-prefixed print-mode input as literal prompt text. |
An unknown --agent name exits with code 1 in headless mode; interactive sessions show Agent Not Found before using the default agent. Combining --print with --prompt-interactive is a usage error with exit code 2. Remote Control is unavailable with Application Default Credentials (AGY_ADC_AUTH). Browser Settings exposes the CLI session settings, and agy remote-control serve loads and saves settings.json.
Headless environment variables
| Variable | Use |
|---|---|
AGY_CLI_CMD_OUTPUT_PERCENTAGE | Limit terminal command output shown in the TUI. |
AGY_CLI_HIDE_LOGO | Hide the startup logo. |
AGY_CLI_HIDE_ACCOUNT_INFO | Hide account email and plan information in the header. |
AGY_CLI_DISABLE_ESCAPE_SEQUENCE_OPTIMIZATIONS | Disable terminal escape-sequence rendering optimizations. |
Streaming input rule
agy --input-format stream-json --output-format stream-json--input-format stream-json requires --output-format stream-json. CLI-handled commands such as /model and /usage should run as separate print-mode commands rather than inside the streaming input session.
Core slash commands
Workspace and conversation
| Command and alias | Use |
|---|---|
/add-dir <path> | Add a directory to the active workspace. |
/codesearchAlias: /cs, /search | Search workspace code. Use -F for literal text. |
/artifact | Open the Artifact Review Panel. |
/diff | Open the diff viewer. |
/open <path> | Open a path in the configured editor. |
/copy, /copy <n>, /copy btw | Copy the latest response, an earlier response, or the full active /btw side-question response. |
/clearAlias: /new | Clear the active conversation context. |
/resumeAlias: /switch, /conversation | Open the conversation picker. |
/rewindAlias: /undo | Roll back conversation history. |
/forkAlias: /branch | Clone the current conversation into a parallel session. |
/rename <name> | Rename the current conversation. |
/exitAlias: /quit | Close the TUI session. |
Settings, models, tools, and accounts
| Command and alias | Use |
|---|---|
/configAlias: /settings | Open the settings editor. |
/permissions | Open the fine-grained permissions manager. |
/model | Open the model picker; search by model name or ID. |
/model <name> | Switch model by name, slug, or label. Base model names use the default thinking level when effort is omitted. |
/model <name> <prompt> | Run one prompt on another model, then return to the current model. |
/effort, /effort <level> | View or set an effort supported by the selected model. |
/agents | Open custom-agent and subagent management. |
/tasks | Monitor background commands, timers, recurring jobs, and other background tools. |
/skills | Browse loaded Agent Skills. |
/skills reload | Reload skills and slash commands without restarting. |
/mcp | Open the MCP server manager. |
/remote-control | Start Remote Control for this session; use /remote-control off to stop. |
/hooks | Browse active hooks, including hooks from enabled plugins. |
/context | View context usage. |
/usageAlias: /quota | View current model quota usage. |
/credits | View G1 credit balance and purchase links. |
/keybindings | Open the shortcut editor. |
/statusline | Customize the status line. |
/title [on/off] | Control terminal window title updates. |
/voiceAlias: /record | Start or stop voice dictation; recordings finalize after 3 minutes 30 seconds. |
/help | Open help. |
/feedback | Open feedback. |
/logout | Remove the saved account session. |
/pluginAlias: /plugins | Browse the plugin marketplace; run inline install, uninstall, enable, disable, or list. |
Workflow slash commands
| Command and plan access | Use |
|---|---|
/boost <task>Access: Paid plans | Run multi-agent deep reasoning. |
/teamwork-preview <task>Access: Paid plans | Start a collaborative agent-team task. |
/goal <task>Access: All plans | Work autonomously until the stated objective is completed. |
/plan <task>Access: All plans | Research the codebase and create a reviewable implementation plan. |
/grill-me <request>Access: All plans | Ask focused questions before implementation. |
/learn <instruction>Access: All plans | Save session patterns as persistent Rules or Skills. |
/schedule ...Access: All plans | Schedule one-time or recurring work. |
/browser <task>Access: All plans | Launch a sandboxed browser subagent. |
/btw <query>Access: All plans | Ask a background side question without running user or workspace hooks. |
Keyboard shortcuts
In Vim Normal and Visual modes, numeric prefixes repeat motions and actions, such as 3dw, 2d3w, and 3dd.
Global and prompt shortcuts
| Shortcut | Action |
|---|---|
Enter | Submit the prompt or active selection. |
Shift+Enter, Ctrl+J | Insert a newline. |
Shift+Tab | Cycle default → accept-edits → plan. |
Esc | Close a panel, halt an active stream, or clear an empty prompt. |
Ctrl+C | Exit the CLI; active work triggers confirmation. |
Ctrl+D | Forward-delete text or exit on an empty prompt. |
Ctrl+L | Clear the terminal buffer. |
Ctrl+V | Paste clipboard content or media. |
Ctrl+O | Expand or collapse detailed tool output. |
Ctrl+R | Open Artifact Review. |
Ctrl+G | Open the prompt or review text in $EDITOR. |
Alt+J | Focus the next subagent waiting for approval. |
Ctrl+K | Approve the pending subagent action. |
Ctrl+A, Ctrl+E | Move to the start or end of the prompt line. |
Ctrl+Z, Ctrl+Shift+Z | Undo or redo prompt edits. |
F5 | Start or stop voice dictation. |
? on an empty prompt | Open the shortcuts panel. |
Navigation and review shortcuts
| Shortcut | Action |
|---|---|
↑, ↓ | Move through highlighted selections. |
←, → | Move between pages in multipage panels. |
PgUp, PgDn | Scroll up or down one page block. |
Shift+↑, Shift+↓ | Scroll up or down half a page. |
Tab | Accept slash-command completion. |
y | Approve a proposed tool action or artifact. |
n | Reject a proposed tool action or artifact. |
A in Artifact Review | Approve all artifacts. |
f in file review | Open the full diff. |
Ctrl+D, Ctrl+U in scrollable views | Scroll half a page down or up. |
Ctrl+F in /resume | Toggle flat and workspace-grouped conversations. |
F2, F4 in conversation picker | Rename or delete the selected item when those bindings are active. |
/ in artifact details | Search the current artifact. |
n, N during artifact search | Move to the next or previous match. |
Shift+N in diff view | Move to the previous diff. |
← / → in /config | Change and immediately save the highlighted setting. |
j / k in diff file view | Move the line cursor down or up; use ← / → to switch files. |
n / N in diff file view | Move to the next or previous change, including across files. |
Shift+Tab in /diff | Switch to the previous view. |
Esc on an empty prompt with an announcement | Dismiss the current announcement permanently. |
Execution modes
| Mode and launch | Behavior |
|---|---|
defaultStart: agy or --mode=default | Pause for review before file edits and creations. |
accept-editsStart: agy --mode=accept-edits | Automatically approve standard file edits and creations. |
planStart: agy --mode=plan | Analyze and produce a plan before writing code. |
Press Shift+Tab to cycle modes during a session. Tool permission rules continue to control shell commands in every execution mode.
Settings reference
Persistent settings use ~/.gemini/antigravity-cli/settings.json. Custom shortcuts use ~/.gemini/antigravity-cli/keybindings.json.
| Setting and values | Use |
|---|---|
colorSchemeDefault / values: "terminal" | Terminal color theme. |
altScreenModeDefault / values: "default"; always, never | Screen buffer mode. |
copyOnSelectDefault / values: true | Copy selected TUI text on mouse release. |
toolPermissionDefault / values: "request-review" | Global tool-approval preset. |
artifactReviewPolicyDefault / values: "asks-for-review" | Artifact review behavior. |
agentModeDefault / values: default, accept-edits, plan | Default execution mode. |
notificationsDefault / values: false | Completion notifications. |
showTipsDefault / values: true | Prompt tips. |
showFeedbackSurveyDefault / values: true | Feedback prompts. |
editorDefault / values: "auto" | External editor. |
editorModeDefault / values: "default" or "vim" | Prompt editing mode. |
vimInsertFirstDefault / values: false | Start Vim prompts in Insert mode. |
pickerGroupingDefault / values: "flat" or "grouped" | Default /resume grouping. |
allowNonWorkspaceAccessDefault / values: false | Permit file access outside recognized workspace roots. |
enableTerminalSandboxDefault / values: false | Sandbox agent-initiated terminal commands. |
useG1CreditsDefault / values: false | Use personal G1 credits in eligible external builds. |
enableTelemetryDefault / values: true | Usage metrics and crash reporting. |
verbosityDefault / values: "medium" (default), "high", or "low" | medium groups related tool calls and thoughts while keeping commands and responses visible. |
runningLightSpeedDefault / values: "medium" | Progress animation speed. |
modelProviderDefault / values: "gemini" for API-key mode | Use direct Gemini API authentication. |
permissionsDefault / values: allow, ask, deny | Fine-grained permission rules. |
queuedMessages | Follow-ups wait for the turn to end by default. Set "send-immediately" to interrupt with new and queued messages in order. |
Permissions and sandbox
Permission presets
| Preset | Behavior |
|---|---|
request-review | Default. Prompt before write, shell, and web tools that require review. |
proceed-in-sandbox | Auto-run terminal commands when sandboxed. |
always-proceed | Run tools without approval prompts. |
strict | Prompt for all non-read tools. |
Fine-grained permission rules
| Rule and behavior | Examples |
|---|---|
denyBlock the matching action. | command(rm -rf), write_file(.git/) |
askRequire approval. | command(*), mcp(sql/execute_mutation) |
allowAuto-approve the matching action. | command(git), write_file(src/), mcp(linter/*) |
Permission precedence is Deny > Ask > Allow. Common resource forms include command(...), read_file(...), write_file(...), read_url(...), execute_url(...), and mcp(server/tool). Sandboxed commands can read and write the CLI artifact and scratch directories.
Terminal sandbox
| Method | Setting |
|---|---|
| Persistent | "enableTerminalSandbox": true |
| One session | agy --sandbox |
| Skip tool permission prompts | --dangerously-skip-permissions |
Windows sandboxed commands run without administrator rights. On macOS, sandboxed commands cannot read ~/Library/Application Support by default; permit access explicitly in sandbox rules when required. Implementation plans still require review unless the Artifact Review setting in /config allows automatic approval.
Config and customization paths
| Item | Path |
|---|---|
| CLI settings | ~/.gemini/antigravity-cli/settings.json |
| Custom keybindings | ~/.gemini/antigravity-cli/keybindings.json |
| Global custom agents | ~/.gemini/config/agents/ |
| Workspace custom agents | .agents/agents/ |
| Global Agent Skills | ~/.gemini/antigravity-cli/skills/ |
| Workspace Agent Skills | .agents/skills/ |
| Installed plugins | ~/.gemini/antigravity-cli/plugins/<plugin_name>/ |
| Global MCP config | ~/.gemini/config/mcp_config.json |
| Workspace MCP config | .agents/mcp_config.json |
| Global developer context | ~/.gemini/GEMINI.md |
| Workspace context | GEMINI.md, AGENTS.md |
Plugins, skills, agents, and hooks
| Command or location | Task |
|---|---|
/agents | Open Agent Manager |
agy agents | List custom agents |
agy --agent <name> | Run a custom agent |
@<subagent> <message> | Message a running or completed subagent |
/skills | Browse Agent Skills |
.agents/skills/ | Create workspace skill |
~/.gemini/antigravity-cli/skills/ | Create global skill |
/hooks | Inspect hooks |
agy plugin list | List plugins |
agy plugin install <path> | Install plugin |
agy plugin enable <name> / agy plugin disable <name> | Enable / disable plugin |
agy plugin uninstall <name> | Remove plugin |
agy plugin import gemini | Import Gemini extension |
/plugin, /plugins | Browse, install, and manage marketplace plugins. |
agy plugin list --json | List every installed plugin as JSON. |
agy plugin install <plugin-name>@antigravity-plugins-official | Install from the official marketplace. |
In /plugin, choose + Install from local directory... to install a local folder and fill in required settings before enabling the plugin. In the Installed tab, type to search, press Enter to finish searching, then use Space to toggle a plugin or Enter to open its details. Plugins can declare subagents in a root-level agents.json, store persistent data through PLUGIN_DATA, and provide executable tools in bin/.
Directory entries in skills.json, rules.json, agents.json, and plugins.json load direct children only; use include_only to select nested items. User and workspace rules share a 20,000-token budget. Sessions started in a subdirectory load customization manifests from each parent .agents/ directory up to the project root. Plugins under ~/.gemini/config/plugins/ that need MCP variables start disabled until enabled.
Custom agent frontmatter
| Field | Use |
|---|---|
agents: | Declare subagents that a custom agent can invoke. |
enable_mcp_tools: true | Enable MCP tools for a custom subagent. The subagent inherits the parent agent’s configured MCP servers. |
excludeDefaultComponents: true | Exclude default prompt sections and built-in tools. Post-invocation hooks continue to run. |
Paths in skills:, plugins:, rules:, agents:, and hooks: resolve relative to the custom agent file. In a multi-repository workspace, subagents with branch or share workspaces receive an isolated copy of each repository.
MCP commands and config
| Command | Task |
|---|---|
/mcp | Open MCP manager |
agy mcp add <name> --type stdio -- <command> [args] | Add stdio server |
agy mcp add <name> --type http <url> | Add HTTP server |
agy mcp list | List servers |
agy mcp enable <name> | Enable server |
agy mcp disable <name> | Disable server |
agy mcp remove <name> | Remove server |
MCP config fields
MCP servers bundled inside plugins use namespaced server names such as <plugin>_<server> when needed to prevent collisions with other plugin or user-configured servers.
| Field | Use |
|---|---|
command | Executable for a local stdio server. |
args | Arguments passed to the local server. |
env | Environment variables. |
cwd | Working directory. |
serverUrl | Remote SSE, Streamable HTTP, or websocket server URL. |
headers | Custom HTTP headers. |
disabled | Disable a server configuration. |
disabledTools | Hide selected server tools. |
MCP servers can keep a tool loaded by including _meta: {"antigravity/alwaysLoad": true} in its tools/list entry. Temporary network failures do not clear saved OAuth sign-ins.
Install and authentication
| Install command | Platform |
|---|---|
curl -fsSL https://antigravity.google/cli/install.sh | bash | macOS / Linux |
irm https://antigravity.google/cli/install.ps1 | iex | Windows PowerShell |
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd | Windows CMD |
Native Android binaries support direct use in Termux without proot-distro.
Installer flags
| Flag | Use |
|---|---|
--skip-aliases | Do not purge or update legacy agy or antigravity aliases. |
--skip-path | Do not modify shell profile PATH. |
Authentication reference
| Method | Requirement |
|---|---|
| Google account | Run agy. The CLI reuses a saved OS-keyring session or opens browser sign-in. |
| Remote / SSH | Open the printed authorization URL locally, then paste the returned code into the remote terminal. |
| Gemini API key | Set "modelProvider": "gemini" and export GEMINI_API_KEY. |
| Custom Gemini endpoint | Set GOOGLE_GEMINI_BASE_URL. |
| Sign out | /logout. API-key mode has no stored account session to clear. |
Gemini CLI migration
| Gemini CLI | Antigravity CLI |
|---|---|
| Gemini extensions | agy plugin import gemini |
~/.gemini/skills/ | ~/.gemini/antigravity-cli/skills/ |
.gemini/skills/ | .agents/skills/ |
MCP entries in ~/.gemini/settings.json | ~/.gemini/config/mcp_config.json |
| Workspace MCP entries | .agents/mcp_config.json |
url / httpUrl for remote MCP | serverUrl |
GEMINI.md / AGENTS.md | Continue to work as workspace context files. |
Troubleshooting
| Problem | Fix |
|---|---|
agy not found | Check PATH and the platform-specific install directory. |
| SSH sign-in stalls | Open the printed authorization URL locally and paste the returned code into the remote terminal. |
| Headless run reports denied actions | Add scoped permissions.allow rules or use the appropriate permission policy. |
Headless run reaches an explicit --print-timeout | Increase the timeout when a complete response is required. The CLI returns available partial output and writes a warning to stderr when the timeout expires mid-turn. |
| Headless run ends on a model or API error | Check the structured AGY_ERROR line on stderr; the run exits with code 3. |
| Streaming input is rejected | Pair --input-format stream-json with --output-format stream-json. |
| Gemini API key is ignored | Set "modelProvider": "gemini" and export GEMINI_API_KEY. |
| Gemini API-key quota is exhausted | Daily quota, project spend caps, and depleted prepaid credits stop retries immediately; short per-minute rate limits still retry. |
| Invalid headless model | Run agy models and use a listed slug. |
| Agent cannot see a folder | Use /add-dir <path> or start from the project root. |
| Remote Control service is unavailable | Run agy remote-control status. Restart it with agy remote-control start if needed. |
| Literal code search needed | Use /codesearch -F <text>. |
| Workspace skill stopped working after migration | Move .gemini/skills/ to .agents/skills/. |
| MCP config fails after migration | Use the dedicated mcp_config.json files and replace legacy url / httpUrl with serverUrl. |
| Reset custom shortcuts | Delete ~/.gemini/antigravity-cli/keybindings.json. |
| Invalid headless schema | Use a valid JSON schema with "type": "object" at its root. Bare type names, missing files, and non-object roots exit with code 1. |
| Windows plugin update or removal is blocked | Close other agy sessions, Antigravity Hub, or the Remote Control daemon if they hold the plugin open, then retry. |
| Authentication expired | Sign in again when the CLI reports Authentication expired. Please log back in.. |
Related Resources
- Antigravity CLI: Gemini CLI Alternative for Agent-first Development
- Claude Code Commands Cheat Sheet
- OpenAI Codex Commands Cheat Sheet
- GitHub Copilot Cheat Sheet
- Grok Build CLI Cheatsheet
- Most Popular Agent Skills on GitHub for Coding Agents
- Gemini & Google AI Timeline










