Google’s launch of the Antigravity ecosystem, specifically version 2.0, marks a significant departure from standard terminal-based utilities. As the direct successor to the Gemini CLI, the Antigravity CLI (invoked via the agy binary) is a high-performance Terminal User Interface (TUI) designed to facilitate agentic software development through a shared agent harness. Written in Go to ensure minimal resource overhead, it is uniquely optimized for keyboard-driven workflows, remote SSH sessions, and headless integration into continuous delivery pipelines.
To help you master this new environment, we have compiled a comprehensive reference guide and cheat sheet detailing its installation, core terminal commands, interactive TUI slash commands, context sourcing syntax, and keyboard shortcuts.
Core System Commands (Shell Terminal)
These commands are executed directly from your terminal shell before entering the interactive TUI environment:
| Command | Description & Usage Context |
|---|---|
agy |
Launches the full interactive TUI mode within the current directory. |
agy update |
Updates the CLI binary and all core agent dependencies. |
agy changelog |
Displays the detailed release notes and fix history. |
agy inspect |
Diagnostic summary of active plugins, custom hooks, and skills. |
agy doctor |
Checks symlinks, environment paths, API keys, and connection health. |
agy plugin list |
Lists installed plugins and their status. |
agy plugin import gemini |
Migrates legacy Gemini CLI extensions into Antigravity plugins. |
agy -p "prompt" |
Runs a one-shot prompt non-interactively and outputs the raw text to stdout. |
agy -c |
Resumes the most recently active conversation thread directly. |
Interactive TUI Slash Commands
Once inside the TUI session, these slash commands manage the agent’s execution lifecycle, routing, and configurations:
| Slash Command | Purpose and Behavior |
|---|---|
/help or ? |
Launches the interactive help overlay menu. |
/rename [name] |
Saves/renames the active conversation under a custom name (e.g., /rename fix-auth-logic). |
/fork |
Branches the current conversation thread into a separate parallel session. |
/resume or /switch |
Opens an interactive picker listing previous sessions to switch between them. |
/rewind or /undo |
Rolls back the conversation history to a previous execution checkpoint. |
/clear |
Clears the current prompt display while retaining the session history. |
/model [name] |
Switches the reasoning model mid-session (e.g., /model gemini-3.5-pro). |
/context |
Inspects active token usage and cache allocation metrics. |
/usage |
Displays live rate-limit statistics and API usage metrics. |
/permissions |
Toggles safety and tool execution modes (request-review, always-proceed, strict). |
/settings |
Opens panel to customize color theme, rendering settings, and telemetry. |
/agents |
Opens the Subagent Manager to view thoughts and logs of parallel workers. |
/tasks |
Displays active background processes, logs, and lets you terminate them. |
/mcp |
Manages Model Context Protocol servers and connection sockets. |
/skills |
Configures and reloads custom, directory-based agentic skills. |
/browser |
Spawns an autonomous Chromium instance for UI navigation and testing. |
/goal |
Runs the agent in non-interactive batch loop mode until a specific goal is reached. |
/grill-me |
Forces the agent to ask clarifying questions before implementation starts. |
/schedule |
Schedules recurring cron jobs or background one-shot timers. |
/open |
Launches the target file in the system default editor ($EDITOR). |
/btw |
Routes a quick side query to a disposable subagent to keep current context lean. |
Workspace Sourcing Syntax (Context Injection)
Reference local codebase elements dynamically in prompts to inject them as context (respects .gitignore rules automatically):
@<filepath>(e.g.,@src/auth.ts): Adds the full content of a specific file.@<dir>/(e.g.,@src/): Recursively adds the contents of a directory.@<glob-pattern>(e.g.,@**/*.py): Adds files matching specific patterns.@<agent-name>(e.g.,@db_expert): Directs the prompt specifically to a defined subagent.
Interactive TUI Keyboard Shortcuts
Use these keyboard bindings to navigate the interactive console efficiently without a mouse:
| Operation | Linux / Windows | macOS |
|---|---|---|
| Submit Prompt | Enter |
Enter |
| Add New Line | Shift+Enter or Ctrl+J |
Shift+Enter or Ctrl+J |
| Clear Buffer / Toggle Panel | Ctrl+L |
Cmd+L |
| Open in Shell Editor | Ctrl+G |
Cmd+G |
| Paste Content | Ctrl+V |
Cmd+V |
| Halt Stream / Close Overlay | Ctrl+C |
Ctrl+C |
| Exit CLI Session | Ctrl+D |
Ctrl+D |
| Teleport Focus to Subagent | Alt+J |
Alt+J |
| Fast Approve Subagent Action | Ctrl+K |
Cmd+K |
| Rapidly Clear Input Box | Esc Esc |
Esc Esc |
Ajarn Spencer Littlewood & Agent Gemini Unleashed for ajarnspencer.com
All rights reserved.
