Antigravity CLI Launcher
Antigravity CLI Launcher is an unofficial VS Code extension that launches Antigravity CLI (agy) in a new side terminal directly from the editor toolbar.
Works on Windows, macOS, and Linux.
Current documented release: 0.1.6. See CHANGELOG.md for release-by-release changes.
Repository: https://github.com/TheStreamCode/antigravity-cli-launcher
✨ Want one launcher for every agent? Try Super CLI — a single sidebar that launches Claude Code, Codex, Copilot, Cursor, Grok, Kilo, Antigravity, OpenCode, and more. Install this launcher for Antigravity alone, or Super CLI for the whole set.
Independent project disclaimer
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.
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
- Antigravity CLI installed by the user and available in the integrated terminal environment
Installation
- Install the extension from the VS Code Marketplace or from a local
.vsix package.
- Open a workspace or file in VS Code.
- 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
| Setting |
Default |
Description |
antigravityCliLauncher.cliCommand |
agy |
Command executed when the launcher button is clicked. |
antigravityCliLauncher.terminalName |
Antigravity |
Base label used for created launch terminals. |
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.
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.
Development
Local verification and packaging:
npm install
npm run check
npm run test:integration
npm run package
npm run package creates the .vsix file in the workspace root.
The repository includes unit tests, metadata checks, VS Code integration smoke tests, and CI coverage for Windows 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.
License
Released under the MIT License. See LICENSE for details.
