Antigravity — AI Coding Agent Interface

An autonomous agent interface for the Antigravity CLI (agy) inside Visual Studio Code. Build, debug, refactor, and ship software with an AI agent pair-programmer directly in your editor.

Disclaimer: This is an independent community extension providing a Visual Studio Code interface for the Antigravity CLI (agy). It is not affiliated with, endorsed by, or sponsored by Google LLC.

Features

• Full Editor-Area Canvas: Dedicated full-width agent workspace (Ctrl+Alt+A / Cmd+Alt+A) designed for focused pair programming.
• Instant Stop & Cancellation: Click Stop at any time to immediately cancel active CLI executions and subprocess trees with zero orphaned processes.
• Three Permission Modes: Choose between Always Proceed, Prompt, and Interactive Terminal with live header badge indicators.
• Interactive Permission Fallback: Automatically detects when headless mode cannot prompt for tool approvals, offering one-click interactive terminal launch.
• Real-time Event Streaming: Stream responses, token counts, reasoning tokens, and execution durations with instant visual feedback.
• Expandable Tool Cards: Detailed accordions for file reads, code edits, terminal commands, directory scans, web searches, and subagents.
• File Modifications & Native Diff: Track changed files with one-click Open and native VS Code side-by-side Diff comparisons against git HEAD.
• Context Tray & Attachment: Attach active editor files (+ Current File), highlighted selections (+ Selection), or uncommitted git diffs (+ Git Changes).
• Multi-Workspace & Multi-Root Support: Dynamically resolves working directory across single projects, multi-root workspaces, and monorepos.
• GitHub Codespaces & Remote Containers: Runs natively in remote extension hosts with zero path mismatch.
• Conversation Management: Multi-thread conversation history with smart auto-titling, thread switching, and local persistence.
• Security & Secret Sanitization: Automatic masking of API keys, OAuth tokens, GitHub tokens, and passwords in logs, storage, and UI.

Requirements

1. Visual Studio Code: Version 1.85.0 or higher.
2. Antigravity CLI (agy): Installed and available in your PATH (or configured via antigravity.cliPath).
3. Authentication: Authenticated with the Antigravity CLI prior to sending requests.

Installation

From VS Code Marketplace

1. Open Visual Studio Code.
2. Go to the Extensions view (Ctrl+Shift+X / Cmd+Shift+X).
3. Search for Antigravity or touseef-zahid.antigravity-agent.
4. Click Install.

From VSIX

code --install-extension antigravity-agent-0.6.0.vsix

Getting Started

1. Authenticate the CLI

In your integrated terminal, ensure agy is authenticated:

agy auth login

2. Open Antigravity

• Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
• Select Antigravity: Open in New Tab.
• Alternatively, use the global shortcut Ctrl+Alt+A (Windows/Linux) or Cmd+Alt+A (macOS).

Permission Modes & Security

Configure via settings under antigravity.permissionMode:

1. always-proceed (Default)

• Behavior: Passes --dangerously-skip-permissions to the CLI, allowing automated agent workflows to run without interactive approval prompts.
• Security Notice: Commands and tool operations execute without interactive confirmation.
• Indicator: ● Always Proceed (blue dot in header bar).

2. prompt

• Behavior: Standard permission mode without bypass flags.
• Fallback: When a tool requires interactive confirmation that headless stream mode cannot prompt for, displays:

  🔒 Antigravity needs interactive permission to continue.
  [Launch Interactive Terminal]   [Switch to Always Proceed & Retry]

• Indicator: ● Prompt Mode (yellow dot in header bar).

3. interactive-terminal

• Behavior: Prompts launch directly in an integrated interactive VS Code terminal session (Antigravity Agent (CLI)) rooted at the active workspace directory.
• Experience: Full interactive terminal with live approval prompts.
• Indicator: ● Interactive Terminal (purple dot in header bar).

Commands & Keybindings

Configuration Settings

Access settings via Preferences: Open Settings and search for Antigravity:

GitHub Codespaces & Remote Containers

The extension is fully verified for remote environments:

• Runs directly inside the Remote Extension Host.
• Spawns the container's local agy binary (/home/codespace/.local/bin/agy or standard PATH).
• Reads and modifies files within the container workspace with accurate path resolution.

Multi-Workspace Support

• Dynamic Folder Resolution: Automatically detects the active workspace folder from the active editor document.
• Monorepos & Multi-Root: Use Antigravity: Select Target Workspace Folder to direct agent tasks to a specific subproject.

Troubleshooting

1. "Antigravity CLI (agy) not found"

• Verify agy is installed: run agy --version in your terminal.
• If agy is installed in a non-standard location, set antigravity.cliPath to its full path.

2. "Authentication required"

• Run agy auth login in an integrated terminal to authenticate.
• Verify authentication with agy whoami.

3. "Antigravity needs interactive permission to continue"

• In prompt mode, tools requiring interactive confirmation cannot be prompted headlessly.
• Click Launch Interactive Terminal or switch permission mode to Always Proceed.

4. Process Stalling or Interruption

• Click Stop to cancel the running process tree.
• Composer unlocks immediately for follow-up prompts.

Privacy & Security

• Local Process Execution: Communicates directly with your local agy binary on your machine or remote container.
• Zero Telemetry: No third-party tracking, analytics, or external telemetry scripts.
• Secret Masking: Automatically redacts API keys, OAuth tokens, GitHub tokens, and passwords in all logs, storage, and UI elements.
• Content Security Policy: Webview uses strict CSP (default-src 'none') with unique per-render nonces.

License

This project is licensed under the Apache License 2.0.