Antigravity CLI
Antigravity CLI is Google’s terminal interface for its Antigravity coding agents. It can read a project, propose a plan, edit multiple files, run commands, inspect failures, and verify its work without requiring the full Antigravity desktop application.
Run `agy` inside a project and it opens a keyboard controlled Terminal User Interface. The first launch covers themes, rendering mode, and workspace trust. macOS, Linux, and Windows are supported.
The important feature is parallel subagents. The main agent can delegate documentation research, code searches, builds, tests, and other parts of a larger job to separate background agents. Type `/agents` to see what each one is doing, inspect its logs, stop it, or deal with a permission request. `Ctrl+k` approves a waiting action without making you leave the main conversation.
Subagents can search code, edit files, run terminal commands, and use web or MCP tools. The main agent controls which tools and permissions they receive. This is useful, but it also widens the area where an incorrect instruction can cause trouble. Antigravity includes command allowlists, deny rules, approval modes, and an optional terminal sandbox using native operating system isolation. The sandbox is disabled by default, so switch it on before allowing agents to run unfamiliar commands.
The TUI has more structure than a plain chat prompt. `/diff` opens an interactive change viewer, `/tasks` shows background work, `/rewind` returns to an earlier checkpoint, and `/permissions` changes the agent’s autonomy level. Themes, status lines, rendering behaviour, and shortcuts are configurable.
Plugins can bundle skills, subagents, rules, hooks, and MCP servers. Antigravity also reads `GEMINI.md` and `AGENTS.md`, so project instructions can live beside the code rather than being pasted into every session.
The CLI shares its agent runtime, permissions, and settings with Antigravity 2.0. A terminal conversation can be exported to the visual application when the job becomes easier to manage through its project and agent panels. That handoff is one of the more practical reasons to choose Antigravity CLI over a standalone terminal agent.
Antigravity CLI compared with Gemini CLI
Both are Google terminal coding agents, and both can inspect files, call tools, run commands, use MCP servers, and work interactively. Antigravity is not simply Gemini CLI with a different prompt.
Agent execution: Gemini CLI normally works through a Reason and Act loop, processing tool calls and results in sequence. Antigravity uses the same agent harness as Antigravity 2.0, with longer multi step work, verification, background tasks, and parallel delegation built into the normal workflow.
Parallel agents: Antigravity treats subagents as a standard product feature. They appear in the `/agents` panel with individual conversations, tool logs, status information, and approval requests. Gemini CLI has experimental agent and subagent settings, but its regular experience remains more linear.
Terminal interface: Both tools have an interactive terminal UI. Gemini CLI also has a particularly useful noninteractive mode through `gemini -p`, plus JSON and streaming JSON output for shell scripts and CI jobs. Antigravity puts more emphasis on its full screen TUI, keyboard shortcuts, agent panels, interactive diffs, and background task monitoring.
Desktop connection: Gemini CLI connects with Gemini Code Assist and IDE agent mode. Antigravity CLI shares configurations with the Antigravity desktop product and can transfer an active terminal conversation into its visual interface.
Migration: Existing Gemini CLI users do not have to rebuild everything manually. First launch can import settings and extensions, while `agy plugin import gemini` converts compatible extensions into Antigravity plugins. Existing `GEMINI.md` and `AGENTS.md` files continue to work. Workspace skills move from `.gemini/skills/` to `.agents/skills/`, and MCP servers use a separate `mcp_config.json` file.
Gemini CLI remains the better fit when you want an open source utility that can be dropped into scripts and CI pipelines. Antigravity CLI makes more sense for complicated repository work where several agents, background tasks, visual monitoring, and desktop handoff are useful.
Individual access starts free with weekly usage limits. Google AI Pro and Ultra plans provide higher limits and shared AI credit pools. Organization access is available through Google Cloud with consumption based billing. The free plan currently includes access to selected Gemini, Claude, and gpt-oss models.
- Terminal coding agent launched with `agy`
- Parallel background subagents
- `/agents` monitoring and approval panel
- Interactive planning and code diffs
- Multi file editing and terminal commands
- Configurable permissions and command rules
- Optional native terminal sandbox
- Conversation checkpoints and rewind
- Plugins containing skills, agents, rules, hooks, and MCP servers
- Support for `GEMINI.md` and `AGENTS.md`
- Import tool for Gemini CLI extensions
- Shared settings with Antigravity 2.0
- Conversation export to the visual application
- macOS, Linux, and Windows support
- Free individual access with paid upgrades
TRY IT