⚡ AI Auto Agent

中文文档 | English

Automated AI agent assistant for Antigravity — auto-retry on failures, auto-accept edits, smart model rotation when quota runs out.

Run your agents hands-free. Walk away. Come back to finished work.

✨ Features

🔀 Model Rotation — How It Works

When the agent encounters a "quota exceeded" or "rate limit" error:

gemini-2.5-pro (quota hit) → claude-4-sonnet → gemini-2.5-flash → claude-4-opus → gemini-2.5-pro ...

1. Detects quota/rate-limit error in the agent panel
2. Auto-switches to the next model in your rotation list
3. Resets retry counter
4. Agent continues seamlessly on the new model

🚀 Setup

1. Enable Debug Mode (Required)

Launch Antigravity with the CDP flag:

# Quick start (one-time)
open -a "Antigravity" --args --remote-debugging-port=9333

For permanent setup, add an alias:

# macOS (add to ~/.zshrc)
alias antigravity='open -a "Antigravity" --args --remote-debugging-port=9333'

# Linux (edit .desktop file or alias)
alias antigravity='antigravity --remote-debugging-port=9333'

# Windows (right-click shortcut → Properties → append to Target)
--remote-debugging-port=9333

⚠️ Important: If Antigravity is already running, you must quit it first before relaunching with the CDP flag. The --args flag is only applied on fresh launch.

Why port 9333? Antigravity's built-in Browser Control uses port 9222. Using 9333 avoids EADDRINUSE conflicts.

2. Install the Extension

From VSIX:

1. Download the .vsix from Releases
2. Ctrl+Shift+P → Extensions: Install from VSIX
3. Select the file → Reload Window

3. Usage

• Toggle: Cmd+Shift+A (macOS) / Ctrl+Shift+A (Windows/Linux)
• Status Bar: Click ⚡ AAA to toggle on/off
• Dashboard: Ctrl+Shift+P → AI Auto Agent: Show Dashboard
• Select Models: Ctrl+Shift+P → AI Auto Agent: Select Models for Rotation (Dynamically fetch and select available models from the IDE)

🛠️ Development

If you want to build and modify the extension locally from source or contribute, please ensure your development environment meets the following requirements:

Prerequisites

• Node.js: v22.x is highly recommended (aligned with our CI/CD pipeline).
• Editor: VS Code v1.100.0+ or Antigravity IDE.
• Extensions: We strongly recommend installing the ESLint and Prettier extensions in your IDE for real-time code style feedback.
• Testing Environment: You MUST launch the Antigravity IDE with the --remote-debugging-port=9333 flag to enable CDP monitoring for extension testing.

Getting Started

# 1. Install dependencies (auto-configures Husky pre-commit Git hooks)
npm install

# 2. Start development (watch mode)
npm run watch

# 3. Global code style check & auto-fix (Powered by ESLint & Prettier)
npm run format
npm run lint

# 4. Run unit tests
npm run test

# 5. Compile and package manually into a .vsix file (Releases are usually handled by CI)
npm run package

Note: The project runs a GitHub Actions CI workflow. Every push triggers automated Linting, TypeScript type-checking, and Unit Tests. Pushing a v* tag will automatically publish the extension to the marketplaces and GitHub Releases.

⚙️ Configuration

All settings are hot-reloaded — changes take effect immediately.

🔥 Running Multiple Agents (Recommended Setup)

Antigravity's Agent Manager uses a single shared webview — only the active conversation renders its DOM. Background agents block on approval buttons that the extension cannot reach.

Solution: Duplicate Workspace

1. Open your project in Antigravity
2. Click File → Duplicate Workspace
3. Each window gets its own webview with a live DOM
4. Start a different agent task in each window
5. The extension auto-accepts in all windows simultaneously

Window 1: Agent → "Implement user auth"     ← ✅ auto-clicking
Window 2: Agent → "Write unit tests"        ← ✅ auto-clicking
Window 3: Agent → "Add API documentation"   ← ✅ auto-clicking

Start 5 agents. Minimize. Walk away. Come back to finished code.

🏗 Architecture

extension.ts
├── cdp/
│   ├── cdpClient.ts     — Multi-session WebSocket manager (vscode-webview:// targets)
│   └── domMonitor.ts    — MutationObserver injection + heartbeat self-healing
└── features/
    ├── autoAccept.ts    — Accept edits, commands, permissions
    ├── autoRetry.ts     — Retry/Continue with max-attempt tracking
    └── modelRotation.ts — Quota detection + model cycling

How CDP Works

Antigravity (--remote-debugging-port=9333)
│
├── /json endpoint → discovers vscode-webview:// targets
│
├── WebSocket Session 1 → webview (Window 1 agent panel)
│   └── MutationObserver injected → clicks buttons → reports via Runtime.addBinding
│
├── WebSocket Session 2 → webview (Window 2 agent panel)
│   └── MutationObserver injected → clicks buttons → reports via Runtime.addBinding
│
└── Heartbeat (10s) → validates sessions, re-injects dead observers

Button Detection Priority

🔒 Safety

• Dangerous commands are blocked — word-boundary matching prevents false positives
• Auto-accept is opt-in (default: false) — you must explicitly enable it
• CDP is localhost only — port binds to 127.0.0.1, not 0.0.0.0
• Fully open source — no telemetry, no network requests, no data collection
• UI-only extension — runs entirely on your local machine, never touches remote servers

📄 License

MIT