the loop
claude-code codex-cli cursor-cli antigravity-cli blog
> esc

Antigravity CLI / terminal reference

Built from Google's official docs as of 9 November 2026 (Antigravity CLI ~v1.5.3). Click any command to copy it. Google's successor to Gemini CLI for free, Google AI Pro and Ultra accounts, which moved to Antigravity CLI on June 18, 2026. It shares its agent harness and common settings with the Antigravity 2.0 desktop app. /help lists what your build has.

Cheat sheet Changes
what changed · 9 November 2026 · v1.5.3 +1 added all changes →

Launch

Everything you can type before you're in a session.

curl -fsSL https://antigravity.google/cli/install.sh | bashInstall on macOS/Linux. Windows: irm https://antigravity.google/cli/install.ps1 | iex.
install.sh --skip-path | --skip-aliasesInstaller flags: don't touch your shell profile PATH, or don't purge legacy agy/antigravity aliases.
agy --versionVerify the install.
agyStart the interactive TUI in the current directory.
agy -i "prompt"Run an initial prompt, then stay interactive.
agy -p "prompt"Headless: run once, print the response, exit. Aliases --print, --prompt.
agy -cContinue the most recent conversation for this workspace. Long form --continue.
agy --conversation <id>Resume a specific conversation by ID.
agy models | agy agentsLook up what --model and --agent take.
agy acpStart an Agent Client Protocol server over stdio for editors such as Zed and JetBrains. agy acp --login signs in first.

no matches in this section

CLI flags

Session shape

--mode accept-edits|auto|planStart in an [execution mode](#approval). Omit for default.
--add-dir <path>Add a directory to the workspace. Repeatable.
--project <id|name> | --new-projectPick a project for the session, or create a new one.
--remote-controlOpen a Remote Control connection for the session on startup.
--remote-agentRun the session's conversations on Remote Agents; with --project, in that remote project.

Model & agent

--model <model>Model for this session (see agy models).
--effort <level>Reasoning effort, low through max depending on the model.
--agent <name>Agent for this session (see agy agents).

Safety

--sandboxRun in the terminal sandbox with OS containment. No effect where the sandbox is unavailable (v1.4.4+).
--dangerously-skip-permissionsAuto-approve all tool permission requests without prompting.

Print mode & debugging

--output-format text|json|stream-jsonShape of stdout in print mode. Default text.
--input-format text|stream-jsonstream-json feeds prompts on stdin; requires --output-format stream-json.
--json-schema <json|file>Enforce structured output in print mode.
--print-timeout <dur>Time limit for print mode. 0 waits for the turn to finish.
--disable-slash-commandsIn print mode, send prompts starting with / as typed instead of running commands or skills.
--log-file <path>Override the CLI log file path.

no matches in this section

Session & history

Typed inside the TUI. Conversations are scoped to the directory you launched agy from.

Conversation

/clearClear the terminal and reset the conversation. Alias /new.
/copy [n|btw]Copy the last response, the n-th most recent, or the latest /btw answer.
/btw <query>Ask a side question in the background without interrupting the main conversation.
/contextOpen the context usage visualization panel.
/diffInteractive diff viewer for changes, turns, and commits.
/usageModel quota usage. Alias /quota.
/model [<model> <prompt>]Choose a model (persists). With a model and prompt, runs just that prompt on it.
/effort [level]Set or inspect the reasoning effort level.

Resume, fork, rewind

/resumeConversation picker for this workspace. Aliases /switch, /conversation.
/forkClone the conversation so far into a new session. Alias /branch. Forks the thread, not your files.
/rewindRoll the conversation back to an earlier message. Alias /undo.
/rename <name>Rename the current session.

Long-running work

/goal <objective>Run autonomously until the goal is verified complete, without intermediate pauses.
/schedule <when> <task>One-shot timer or recurring cron schedule that wakes the agent with an instruction.
/tasksTask Manager panel for background shell execution logs.
/boost <task>On-demand multi-agent deep reasoning loops.
/teamwork <task>Collaborative multi-agent teams for long-horizon projects. Paid plans.

no matches in this section

Execution modes & plan

Cycle with Shift+Tab: 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.

defaultInline diff review before any file write; asks before terminal commands.
accept-editsAuto-approves file creates and edits inside the workspace; still asks before commands. Subagents inherit it.
autoAuto-approves edits, runs commands in the terminal sandbox, and auto-evaluates commands outside it. Needs the sandbox and a personal account; hidden where unavailable.
planAnalyze and outline steps before writing code.

Planning & permissions

/plan [task]Explore, clarify requirements, and draft a reviewable Implementation Plan.
/grill-me [task]Agent interviews you one question at a time, with a recommended answer for each, before starting.
/artifactOpen the Artifact Review panel. Also Ctrl+R.
/permissionsInteractive tool permissions manager.
fOn a pending edit, open the full-screen diff. Esc does not dismiss a pending edit.

no matches in this section

Plugins, MCP, subagents & hooks

Plugins

agy plugin install <name>Install from the official marketplace (<name>@antigravity-plugins-official). Needs a signed-in session.
agy plugin install <github-url|path>Install from a GitHub repository or a local plugin directory.
agy plugin import [gemini|claude]Convert extensions from ~/.gemini/extensions/ or plugins from ~/.claude/plugins/.
agy plugin list [--json]Installed plugins with state, version, source and component counts.
/pluginPlugins Manager. Inline: install, uninstall, enable, disable, list. Alias /plugins.

MCP servers

/mcpMCP Manager overlay: live status, reload configs, connection logs.
~/.gemini/config/mcp_config.jsonGlobal server definitions under mcpServers. Workspace: .agents/mcp_config.json.
"serverUrl": "https://…"Remote server key (url also accepted). Gemini CLI's httpUrl isn't supported.

Subagents & hooks

/agentsAgent Manager: switch custom agents and monitor background subagents.
@<subagent> messageSend a subagent new instructions directly, bypassing the parent.
/hooksBrowse the active hooks.
.agents/hooks.jsonWorkspace hooks. Global: ~/.gemini/config/hooks.json. Hooks in settings.json aren't loaded.

no matches in this section

Skills & rules

Skills follow the agentskills.io standard; each skill becomes a slash command (deploy-staging → /deploy-staging). Rules are cumulative constraints added to the prompt.

Skills

/skillsBrowse loaded local and global skills. /skills reload re-reads them from disk.
.agents/skills/<skill>/SKILL.mdWorkspace skill, also read from parent folders up to the repo root. Legacy .agent/skills still works.
~/.gemini/config/skills/<skill>/Global skills, shared with the Antigravity App. The CLI also reads ~/.gemini/antigravity-cli/skills/ and ~/.gemini/skills/.
/learn [instruction]Turn session corrections into persistent rules or skills via a reviewable proposal.

Rules

AGENTS.md | GEMINI.mdAlways-on, no frontmatter. Loaded from the workspace and each parent up to the repo root, also under .agents/.
.agents/rules/*.mdModular 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.
~/.gemini/GEMINI.md | ~/.gemini/AGENTS.mdGlobal always-on rules. Modular global rules: ~/.gemini/config/rules/*.md.
@[label](path)Inside a rule file, inline another file's contents. Rule files are truncated at 24,000 bytes.

no matches in this section

Config & environment

/config (alias /settings) edits ~/.gemini/antigravity-cli/settings.json interactively.

settings.json keys

"agentMode"Default execution mode: "", "accept-edits", "auto", "plan".
"toolPermission"request-review (default), proceed-in-sandbox, always-proceed, or strict. Deny rules apply in every mode.
"permissions"Allow, ask, and deny rules for the agent's tools.
"enableTerminalSandbox"Contain every local command the agent runs. Default false.
"allowNonWorkspaceAccess"Let the agent read and edit outside the workspace, subject to permissions.
"artifactReviewPolicy"Whether the agent waits on artifact review: asks-for-review, agent-decides, always-proceed.
"queuedMessages"queue holds a message until the turn ends; send-immediately interrupts.
"notifications"Bell and desktop notification when the agent needs you or finishes.
"editorMode": "vim"Modal prompt editing. editor picks the external program for Ctrl+G.
"$schema"https://antigravity.google/schemas/v1/settings.json for editor autocomplete.

In-session & environment

/keybindingsOpen the Keyboard Shortcut Editor.
/statusline | /titleCustomize the status bar, or toggle terminal title updates.
/logoutDisconnect and purge tokens from the OS keyring.
GEMINI_API_KEYUsed only with "modelProvider": "gemini" in settings. GOOGLE_API_KEY and .env files are ignored.
GOOGLE_GEMINI_BASE_URLSend model requests to a different Gemini-compatible endpoint.

no matches in this section

Keyboard & input

Rebind anything in ~/.gemini/antigravity-cli/keybindings.json (delete it to reset).

Prompt

Shift+Enter / Ctrl+JNewline without submitting.
Shift+TabCycle execution modes.
Ctrl+GCompose the prompt in $EDITOR.
Ctrl+VPaste images or clipboard blocks.
Ctrl+OExpand or collapse detailed tool reasoning output.
Ctrl+RArtifact Review panel.
Ctrl+_ / Ctrl+Shift+ZUndo / redo an edit.
F5Start or stop voice dictation.

Control

EscClose panels, halt the stream, or clear an empty prompt.
Ctrl+CExit (confirms if the agent is working).
Ctrl+DExit on an empty prompt; forward-delete otherwise.
Ctrl+LClear and redraw the terminal.
Alt+JJump to the next subagent awaiting confirmation.
Ctrl+KApprove the pending subagent action without switching panels.
y / nApprove or reject the proposed tool, command, or artifact.
AIn the Review panel, approve all artifacts.

no matches in this section

Headless & scripting

-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.

agy -p "query" --output-format jsonOne JSON envelope: conversation_id, status, response, usage, …
agy -p "query" --output-format stream-jsonNDJSON: one init, step_update events, one result.
agy -p "query" --json-schema '<schema>'Parsed result lands in structured_output.
agy -p "more" --continueHeadless runs are stateless; -c or --conversation <id> picks up prior context.
agy --input-format stream-json --output-format stream-jsonOne long-lived process; write {"event":"user","message":{"content":"…"}} lines to stdin, one result per turn.
exit codes0 on success; non-zero with the reason on stderr. JSON modes also set status and error.

no matches in this section

File map

~/.gemini/antigravity-cli/settings.jsonCLI settings.
~/.gemini/antigravity-cli/keybindings.jsonCustom key bindings.
~/.gemini/antigravity-cli/cache/last_conversations.jsonWorkspace → last conversation map that -c reads.
~/.gemini/config/Global mcp_config.json, hooks.json, skills/, agents/, rules/, plugins/.
AGENTS.md · GEMINI.mdWorkspace rules, always on.
.agents/rules/ · .agents/skills/Workspace rules and skills.
.agents/agents/<name>.mdWorkspace subagent (or <name>/agent.md).
.agents/mcp_config.json · .agents/hooks.jsonWorkspace MCP servers and hooks.

no matches in this section

Coming from Gemini CLI

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.

gemini → agyThe binary.
agy plugin import geminiConvert extensions to plugins; legacy commands become skills, MCP servers move to mcp_config.json.
.gemini/skills/ → .agents/skills/Workspace skills must be moved by hand. ~/.gemini/skills/ still loads.
~/.gemini/settings.json → ~/.gemini/config/mcp_config.jsonMCP servers leave the settings file. Workspace: .agents/mcp_config.json.
httpUrl → serverUrlRemote MCP server key. url still works.
GEMINI.md · AGENTS.mdUnchanged — workspace and ~/.gemini/GEMINI.md context still loads.

no matches in this section