Antigravity CLI Setup
Antigravity CLI (agy) is Google's command-line coding agent and the successor to Gemini CLI. It has ACP built in (agy acp), so no adapter is needed. Agent Console ships it as a built-in agent.
Check Google's terms before you sign in
Google's ACP guide shows editors running agy acp with your Antigravity sign-in. Google's FAQ also says that using third-party software with an Antigravity login breaks its Terms of Service, and recommends a Gemini Enterprise or Google AI Studio API key for third-party coding agents. If that applies to you, use the API key option below.
Install and Configure
- Install Antigravity CLI by following Google's instructions. On macOS with Homebrew:
brew install --cask antigravity-cli- Confirm your version includes ACP:
agy acp --help- Find the installation path:
which agy
# Example output: /opt/homebrew/bin/agywhere.exe agyOpen Settings → Agent Console and open the Antigravity CLI page. The default Path (
agy) works in many cases. If the agent isn't found, set the full path from step 3, or click Auto-detect.Keep Arguments set to
acp(the default).
Added agy acp as a custom agent before this built-in existed? Delete that custom agent under Custom agents, so Antigravity doesn't appear twice in your agent lists. If your custom agent has a different id, chats you started with it keep running on it until you delete it. If you gave it the id antigravity-acp, those chats already run on the built-in, and Agent Console renames the custom agent with a -2 suffix the next time you edit its id.
Authentication
Option A: Google account sign-in
- Run Antigravity CLI once in a terminal and sign in:
agyTo sign in without a browser (for example over SSH), run agy acp --login instead.
- In Agent Console, leave the API key field empty. Antigravity CLI reuses the sign-in you just made.
Option B: Gemini API key
- Get an API key from Google AI Studio.
- In Settings → Agent Console → Antigravity CLI → API key, choose or create a secret with the key.
Agent Console passes the key to Antigravity CLI as GEMINI_API_KEY. The key is kept in Obsidian's secret storage, not in your vault's plugin settings. When a key is chosen, it replaces any GEMINI_API_KEY in the Environment variables field. If the chosen secret has no value on this device (for example after your settings synced from another computer), Antigravity CLI starts with an empty key, which also overrides a GEMINI_API_KEY in Environment variables: it works only if you have signed in with agy. Choose the secret again or clear the field.
Models and thinking level
Antigravity CLI offers a Model and a Thinking level picker in the chat composer. The pickers show what you picked, so the chat header leaves them out. Hover the header to see both: the model, and the thinking level as Effort.
Optional arguments
Add these after acp in Arguments:
| Argument | What it does |
|---|---|
--disable-telemetry | Turns off Antigravity CLI's telemetry for this agent |
--sandbox | Runs commands with terminal sandbox restrictions |
--log-file <path> | Writes the agent's log to a file you choose |
Google's ACP guide lists every flag.
Verify Setup
- Click the robot icon in the ribbon or use the command palette: "Open chat"
- Switch to Antigravity CLI from the agent menu in the chat header
- Send a message to check the connection
Troubleshooting
- "Session Creation Failed … Authentication required" – Antigravity CLI isn't signed in. Run
agyonce in a terminal to sign in, or set an API key (Option B), then try again. - The agent doesn't start – run
agy acp --helpin a terminal. If it works there but not in Agent Console, set Path to the full path fromwhich agy. - More detail – Antigravity CLI writes logs to
~/.gemini/antigravity-cli/log/.
Having other issues? See Troubleshooting.