# Antigravity Features and Practical Usage
🚀 No browser, no IDE—just a terminal and an agent ready to build. That is the promise of the Antigravity CLI (agy).
📌 Title and Feature URL
Title: Antigravity CLI
URL:
📝 Overview
The Antigravity CLI brings the same agent harness that powers Antigravity 2.0 to the command line. It lets you spin up new agents instantly without a GUI, and it runs fast over SSH on remote servers or inside containers. You drive it with the agy command.
🔧 How It Works
agy shares the IDE's core while adding terminal-first extensibility:
- AGENTS.md at the repo root supplies shared project instructions, replacing the older .gemini/ convention with a new project-instructions system.
- Agent Skills load from a global scope (~/.gemini/antigravity-cli/skills/) and a per-workspace scope (.agents/skills/).
- Hooks intercept agent actions at lifecycle stages (before a tool call, after a model call, at loop stop conditions) to automate checks and formatting.
- MCP servers can be configured as local processes or remote hosts to reach external data and tools.
- Subagents and Plugins are also first-class extensibility features.
🛠 Practical Usage
- Install on macOS/Linux with curl -fsSL | bash, or on Windows via PowerShell.
- Run agy and authenticate with a Google account or a GCP project on first use.
- Run agy inspect to see exactly what context is loaded: AGENTS.md, available skills, plugins, registered hooks, and connected MCP servers.
- Use /goal to run autonomously, /grill-me to have the agent ask clarifying questions first, /schedule for recurring runs, and /browser to opt into browser capabilities.
🎯 Use Cases
- Run agents directly from the terminal where you cannot open an IDE, such as SSH or remote sessions.
- Debug "why isn't my skill firing?" or "which MCP loaded?" by inspecting the live context with agy inspect.
- Launch lightweight agent work inside CI containers.
- Standardize per-repo conventions by pairing AGENTS.md with shared team skills.
⚠️ Caveats
- The default model is Gemini 3.5 Flash (High); preview rate limits are generous, but production workloads need a billing-enabled GCP project.
- When skills or hooks misbehave, check the real loaded state with agy inspect before blaming your config.
- Note that global and workspace scopes resolve skills from different directories.
#
Antigravity# #
DevTools#