Antigravity CLI Launcher

One click. Fresh side terminal. agy ready.
A focused, unofficial VS Code extension that launches Antigravity CLI in VS Code, Cursor, and Windsurf on Windows, macOS, and Linux.

Visual Studio Marketplace · Open VSX · Latest VSIX

Independent and unofficial. This extension is not affiliated with, endorsed by, sponsored by, or approved by Google. Installation and authentication remain under your control.

Why This Launcher

Quick Start

1. Install from the Visual Studio Marketplace, Open VSX, or the latest GitHub Release.
2. Install Antigravity CLI yourself from the official Google installation guide and make sure agy works in an integrated terminal.
3. Open a file or workspace and click the launcher button in the editor title bar.

Current documented release: 0.1.11. See CHANGELOG.md for release-by-release changes.

Features

• Adds a launcher button to the editor title toolbar
• Opens a fresh side terminal beside the active editor on every launch
• Uses the active editor workspace when available, with a fallback to the first open workspace folder
• Runs the configurable Antigravity CLI command, defaulting to agy
• Detects when the default agy command is missing and offers the official installation guide
• Opens installation guidance in the external browser without downloading or executing installer content
• Never changes PATH or shell profile files
• Supports quoted Windows executable paths
• Does not collect telemetry, analytics, or personal data

Requirements

• VS Code 1.103.0 or newer
• Antigravity CLI installed by the user and available in the integrated terminal environment

Installation

1. Install the extension from the VS Code Marketplace or from a local .vsix package.
2. Open a workspace or file in VS Code.
3. Click the Antigravity CLI Launcher button in the editor title toolbar.

If Antigravity CLI is already installed and agy is on PATH, the launcher starts immediately.

Install Antigravity CLI yourself by following the official Google installation guide. Review the instructions before running any command, then restart VS Code if new terminals do not recognize agy.

Installation Guidance

When the default agy command is missing, the extension explains that installation is user-directed and offers Open Installation Guide. This opens Google's authoritative Antigravity CLI installation page in the external browser.

For security and marketplace scanner compatibility, the extension does not download installer scripts, execute installation commands, create temporary installer files, change PATH, edit shell profiles, or rewrite the configured CLI command. Installation remains entirely under the user's control.

How It Works

Each launch creates a new terminal beside the current editor and sends the configured command immediately. Existing terminals are not reused.

When possible, the launcher opens the terminal in the workspace folder of the active editor. If the active editor is outside the workspace, it falls back to the first workspace folder in the current VS Code window.

The launcher checks command availability through VS Code terminal shell integration, so detection follows the same environment used by the integrated terminal rather than the extension host process.

For safety, the launcher is disabled in untrusted workspaces. The executable command is treated as machine-level user configuration and workspace-controlled command values are ignored, preventing a repository from changing the command that runs when you click the toolbar button.

Configuration

antigravityCliLauncher.cliCommand is a machine-level setting. Configure it from your user or remote machine settings, not from repository workspace settings.

Use the Command Palette to open the extension settings:

• Antigravity CLI Launcher: Open Settings

Examples:

Default command:

"antigravityCliLauncher.cliCommand": "agy"

Windows absolute executable path:

"antigravityCliLauncher.cliCommand": "\"C:\\Users\\You\\AppData\\Local\\agy\\bin\\agy.exe\""

macOS or Linux absolute executable path:

"antigravityCliLauncher.cliCommand": "\"/Users/you/.local/bin/agy\""

Troubleshooting

The terminal opens but agy is not recognized

Follow the official Google installation guide, then restart VS Code so new terminal processes inherit any environment changes made during your user-directed setup.

Windows PATH was updated but PowerShell still cannot find agy

Confirm that %LOCALAPPDATA%\agy\bin is present in your user PATH. Restart VS Code and open a new terminal. Existing terminal sessions do not automatically reload Windows user environment changes.

Nothing happens after clicking the button

Check antigravityCliLauncher.cliCommand and verify that the same command works in a regular integrated terminal.

Custom executable path on Windows

Quote executable paths that contain spaces. This is required for paths such as "C:\Program Files\agy\agy.exe".

Multi-root workspaces

The launcher prefers the workspace folder of the active editor. To control where Antigravity CLI starts in a multi-root window, open a file from the target workspace before clicking the toolbar button.

Privacy

Antigravity CLI Launcher does not collect telemetry, analytics, or personal data.

The extension launches commands in your local VS Code integrated terminal. Antigravity CLI itself is a separate product with its own behavior, authentication, network access, and terms.

Legal And Trademarks

This repository contains only the extension code and original launcher assets. It does not include official Google or Antigravity logos.

See TRADEMARKS.md for the full affiliation and trademark notice.

Repository Structure

Development

Requirements: Node.js 22 or newer and npm. The repository uses npm with the committed package-lock.json.

Local verification and packaging:

npm ci
npm run check
npm run audit
npm run package

Individual steps:

npm run compile           # Clean and compile TypeScript into out/
npm run watch             # Incremental compile
npm run test:unit         # Unit, security, and metadata tests
npm run test:integration  # VS Code Extension Host smoke test

npm run check compiles the extension, runs both suites, and lists the files that would ship in the VSIX. npm run package creates the .vsix file in the workspace root; it is ignored by git.

Set VSCODE_TEST_VERSION to an exact VS Code version before npm run test:integration when validating a compatibility floor. CI tests the latest stable editor on Windows, macOS, and Linux, plus the declared minimum VS Code 1.103.0 on Linux.

Open the repository in VS Code and press F5 to launch the Run Extension debug configuration, or pick Extension Tests to debug the smoke test.

The repository includes unit tests, metadata and security checks, a VS Code Extension Host smoke test, dependency auditing, and CI coverage for Windows, macOS, and Linux.

Support

Open a GitHub issue for bugs and feature requests. For support details, see SUPPORT.md.

Financial support for the independent maintainer is available through GitHub Sponsors: github.com/sponsors/TheStreamCode.

Related Project

Need one launcher for several coding agents? Super CLI provides a single sidebar for Claude Code, Codex, Copilot, Cursor, Grok, Kilo, Antigravity, OpenCode, and more.

Independent Project Notice

This extension is an independent, unofficial project. It is not affiliated with, endorsed by, sponsored by, or approved by Google. Antigravity, agy, Google, and related names, logos, and trademarks are property of their respective owners. This project does not include official Google or Antigravity logos.

License

Released under the MIT License. See LICENSE for details.