AGENTIC CODING, CLI WORKFLOWS & DEV SETUPS

How to Install and Use Google Antigravity CLI (agy) on Windows, Mac, and Linux

Published Oct 14, 2026 • 4 min read • 21 readers

Key Takeaways & Quick Direct Answer

Google Antigravity CLI (binary name: agy) is the official terminal agent designed to run autonomous coding workflows across your repositories. Unlike web chat windows, agy reads your local folder structure, executes terminal tests, edits multiple files simultaneously, and uses your local environment tools directly.

Prerequisites

You need Node.js 20 or higher installed, along with a Google Cloud or Google AI Pro account for API authentication.

Quick Installation

Open your terminal and run: npm install -g @google/antigravity-cli (or curl -fsSL https://antigravity.google/install.sh | bash on macOS and Linux).

Verify the Install

Type 'agy --version' to confirm the CLI is linked properly. If you see a command not found error, ensure your global npm bin folder is in your system PATH.

Authentication

Run 'agy auth login'. This launches your browser to sign into your Google account and link your active AI subscription or project API key.

Running Your First Task

Navigate to your repository and type 'agy init'. Then provide a task like: agy 'Review the auth routing in /app and write missing Jest unit tests'.

Turbo Mode Tip

When working in a throwaway test branch or container, use 'agy --dangerously-skip-permissions' so the agent does not pause every two minutes asking you to approve shell commands.

RunAnAi Takeaway

Running agy locally saves you hours of copying code into browser chats. Keep your tasks focused on one folder at a time to minimize token consumption and keep your context window clean.