Antigravity Cleaner Architecture
The standalone, pure-Go systems utility that permanently neutralizes Google Antigravity Error 403 regional blocks,
severs background telemetry surveillance, silences write EIO broken pipe stream crashes, and injects smart No-TUN proxies.
Google Account Country Association Check
Google binds regional eligibility directly to account history. Before running Cleaner for the first time, verify your account country in 30 seconds:
Google Account Country Verification
Visit the official Google Country Association Form. If it indicates a supported territory (e.g. United States, Germany), your account is ready. If it displays an embargoed region, enable your proxy, submit the form with "I frequently use a VPN", or register a fresh account.
Quick One-Liner Installation (CLI & GUI)
The fastest way to fetch the latest pre-compiled standalone binary across platforms with zero external prerequisites:
curl -fsSL https://raw.githubusercontent.com/dalroot/antigravity-cleaner/main/install.sh | bash
irm https://raw.githubusercontent.com/dalroot/antigravity-cleaner/main/install.ps1 | iex
🖥️ Option 1: Standalone GUI Launcher (Zero-Install, Pure Go)
Compiled in native pure Go: 100% portable single executable with zero installation needed. Simply double-click the executable to launch the lightweight desktop window with automated 3-step repair:
Click [ ① ⚡ Auto-Fix ]
Click the primary button and wait 2–3 seconds. Cleaner automatically applies the machine-code patch to the core engine,
neutralizes CLI gating, unlocks isGoogleInternal in the Electron frontend, and injects the Zero-Log ASAR shield.
Upon completion, the status box confirms with green: ✔ STEP 1 DONE! Next: Click [ ② 🚀 Launch IDE ].
Click [ ② 🚀 Launch IDE ]
Spawns Google Antigravity with smart direct proxy routing (ports 10808 / 7890). The IDE is instantly connected with full Gemini AI code intelligence, bypassing the need for laggy whole-system TUN mode.
Click [ ③ 📌 Create Shortcut ]
Generates a permanent desktop shortcut and application menu launcher pre-configured with proxy routing. For future coding sessions, you can launch Antigravity directly from this shortcut without ever reopening Cleaner!
Real-Time Zero-Telemetry Toggle
The GUI includes a live Zero-Telemetry toggle on the bottom bar. Keep it enabled to ensure prompt history, terminal commands, and git commit hashes are never broadcast to Google logging endpoints.
⌨️ Option 2: Terminal CLI Reference (Power Users)
For developers working in Linux, macOS, headless servers, or automated AI agent workflows:
Interactive Fullscreen TUI
Run antigravity or ag-cleaner in your terminal to open the interactive Lipgloss dashboard with sequential menus and latency cards:
# Open interactive Lipgloss TUI
ag-cleaner
Scriptable Subcommands
Use these direct subcommands for script automation and headless environments:
# 1. Apply all patches (Core binary, CLI, IDE frontend, ASAR shield)
ag-cleaner patch all
# 2. Launch Antigravity directly with smart proxy (No TUN mode needed!)
ag-cleaner launch
# 3. Create permanent desktop shortcut pre-configured with proxy
ag-cleaner create-launcher
# 4. Run concurrent health audit & latency probes
ag-cleaner doctor
# 5. Generate diagnostic report & copy to clipboard for support
ag-cleaner report
# 6. Check for updates and self-update to latest release
ag-cleaner update
# 7. Reset HTTP 429 quota without losing conversation history
ag-cleaner clean
# 8. Revert all binaries to untouched original factory condition
ag-cleaner restore
# 9. Terminate any orphaned language_server zombie processes safely
ag-cleaner kill
# 10. Launch Desktop GUI window from terminal
ag-cleaner gui
🩺 System Health Audit & Doctor Diagnostics
The ag-cleaner doctor command performs automated parallel validation of local proxy sockets,
patch integrity, binary permissions, and Google Antigravity connectivity:
ag-cleaner doctor
# Output:
# [✓] Scanning local SOCKS5/HTTP proxy listeners... (Found 127.0.0.1:10808)
# [✓] Verifying binary integrity & RAX+8 machine-code patch... (OK)
# [✓] Auditing 8-flag enterprise isolation & zero-telemetry rules... (Enforced)
# [✓] System Doctor Status: HEALTHY (All checks passed in 2.48s)
The 9 Core Engineering Layers & Deep Patches
Antigravity Cleaner deconstructs and patches Google Antigravity across 9 independent system layers using POSIX atomic inode swaps:
| Layer | Target File | Mechanism & Code Hook | Primary Benefit |
|---|---|---|---|
| 01 | language_server binary |
Machine-code patch: RAX+8 hasValidAuth = 1 |
Permanently lifts 403 blocks & location restriction |
| 02 | agy CLI tool |
Client-side eligibility bypass routine | Neutralizes regional gating in command-line tools |
| 03 | main.js Electron frontend |
Sets isGoogleInternal = true; purges V8 cache |
Unlocks preview tools & agent sidecars |
| 04 | app.asar bundle |
Silences level: 'silly'; captures write EIO |
Stops broken pipe stream termination |
| 05 | VS Code Extension | Update channel lock & hash check suppression | Prevents background silent overwriting |
| 06 | Runtime Wrapper | Enforces 8 enterprise flags (--disable_telemetry) |
Allows sidecars & blocks beacons |
| 07 | Network Layer | Strict local loopback on 127.0.0.1 |
Zero prompt & git metadata exfiltration |
| 08 | Quota Storage | Flushes 16 cached rate-limit tokens in 0.002s | Instant 429 reset with 100% chat preservation |
| 09 | Proxy Engine | Direct SOCKS5 injection (10808/7890) + 15s KeepAlive | Zero TUN friction; resists DPI drops |
1-Click Clean Rollback Guarantee (.agybak)
Every binary modification is 100% reversible. Before altering a single byte, Cleaner automatically creates an untouched factory backup with the .agybak extension. Revert back to virgin factory state anytime via GUI [Restore] button or CLI ag-cleaner restore.
Zero-Telemetry Engine & Privacy Shield
By default, Google Antigravity continuously transmits background telemetry packets to Google endpoints.
Our 8-flag enterprise isolation wrapper injects --disable_telemetry=true into the core binary runtime:
- 100% Severed Phone-Home Channels: Google receives zero telemetry packets, zero git metadata, and zero IP trace beacons.
- 100% Offline Local Execution: Operates entirely locally on
127.0.0.1with zero external network requests during patching. - Zero Chat Loss: Surgical quota reset targets only corrupt rate-limit cookies and DIPS caches. Prompts and project histories remain intact.
Smart SOCKS5 Proxy Injection (One-Time Temporary Connect)
Cleaner eliminates the friction of configuring proxy settings or running CPU-intensive system-wide TUN adapters:
Zero-Configuration & Turn Off VPN After Launch
1. Zero Manual IP/Port Setup: Cleaner automatically detects your local proxy client (v2rayN, Nekoray, Clash, Sing-box) on standard SOCKS5 ports (10808 / 7890).
2. Connect Once & Turn Off: Simply launch your proxy client, click [Launch IDE] (or run ag-cleaner launch), and once Antigravity establishes connection, you can safely turn off your VPN/proxy completely! The IDE maintains its authorized stream and works stably without keeping a VPN running in the background.
3. Only Reconnect If Dropped: Only in the rare event that your network node drops will you need to briefly enable the proxy again to re-authenticate.
4. Traditional VPNs: Full-tunnel VPNs (like Windscribe) that route the entire operating system require zero extra configuration.
Real-World Error Troubleshooting Clinic
Diagnoses and instant surgical fixes for the 5 most common failure modes encountered by Antigravity developers:
Error 01: Agent Terminated Due to Error (write EIO / Pipe Failure)
Quote: "Agent terminated due to error. You can prompt the model to try again..."
Cause: Sudden pipe breakdown caused by verbose raw logging (write EIO) or middlebox TCP connection timeouts during long reasoning chains.
Fix: Click [Auto-Fix]. The ASAR Zero-Log Shield silences broken pipe exceptions and injects 15s TCP KeepAlive heartbeat socket tuning.
Error 02: Network Issue Connecting to Server (DPI Severance)
Quote: "There was a network issue connecting to the server, please try again. Error ID: 95ea05dd..."
Cause: Deep Packet Inspection (DPI) firewalls dropping idle gRPC streams or telemetry probes exposing real IP midway through conversation.
Fix: Launch with ag-cleaner launch (or GUI Launch IDE). Isolates streams over direct SOCKS5h socket with zero telemetry exfiltration.
Error 03: Authentication Gating / 403 Forbidden (/auth-success)
Quote: "Google 403. That's an error. Your client does not have permission to get URL /auth-success..."
Cause: Google regional check flagging browser login redirect from sanctioned regions.
Fix: Run [Auto-Fix]. Sets hasValidAuth = true, passes enterprise stubby flags, and clears poisoned auth tokens.
Error 04: Proxy Connection Refused (dial tcp 127.0.0.1:10808)
Quote: "proxyconnect tcp: dial tcp 127.0.0.1:10808: connect: connection refused"
Cause: Local proxy client (Xray, Clash, Sing-box, NekoBox) is closed or listening on a different port (e.g. 7890 / 2080).
Fix: Run ag-cleaner doctor. Automatically scans open local proxy ports and re-configures IDE routing instantly.
Live System Benchmarks & Test Logs
| Metric | Measured Value | Verification Source | Status |
|---|---|---|---|
| In-Memory Pattern Scanning | 1,901.84 MB/s (~1.9 GB/s) |
benchmarks.log | Verified |
| 171MB Binary Patch Duration | 0.23 seconds |
benchmarks.log | Verified |
| Doctor Concurrent Audit | ~2.5 seconds |
live_system_test.log | Verified |
| Surgical 429 Cache Flush | 16 artifacts in 0.002s |
live_system_test.log | 0 Chat Loss |
Comparison Matrix
| Feature | Python Patchers | DLL Injectors | ⚡ Antigravity Cleaner Pro |
|---|---|---|---|
| Language & Runtime | Python 3 (requires pip) | Windows C++ / DLL | Pure Go (Zero runtime) |
| User Interface | Terminal stdout | Basic console | Standalone GUI + Lipgloss TUI |
| No-TUN Proxy Launcher | ❌ Forces root TUN | ❌ None | ✅ Direct SOCKS5 10808/7890 |
| Zero-Log ASAR Shield | ❌ None | ❌ None | ✅ Catches write EIO crashes |
| Surgical 429 Reset | ❌ Wipes all chat history | ❌ Deletes everything | ✅ Cleans cache, 0 chat loss |
Frequently Asked Questions
Is Antigravity Cleaner safe to run on my system?
Yes. 100% auditable open-source code under Apache 2.0. Cleaner runs completely locally on 127.0.0.1 with zero internet access required during patching. It contains no shady DLLs, no telemetry beacons, and passes continuous GitHub CodeQL and Govulncheck automated security audits.
Will running Cleaner wipe my conversation history or project workspaces?
Zero Chat Loss Guarantee. Unlike alternative scripts that destructively delete your entire User/globalStorage folder, Antigravity Cleaner's surgical 429 reset flushes only the 16 corrupted rate-limit cookies and DIPS cache tokens. Your chat history, login session, and workspace settings remain 100% intact.
How does Antigravity Cleaner bypass Error 403 Forbidden without global TUN mode?
Google Antigravity enforces client-side eligibility checks in main.js, agy CLI, and internal extensions alongside Geo-IP checks. Running antigravity-cleaner patch all neutralizes these client-side gates, while antigravity-cleaner launch injects targeted process-level proxy routing (--proxy-server=socks5://127.0.0.1:<port>) directly into Chromium, leaving the rest of your system on direct high-speed internet.
How do I resolve Error 429: Resource has been exhausted (Too Many Requests)?
Run antigravity-cleaner clean or click [Reset 429] in the GUI. In 0.002 seconds, it surgically clears corrupted GPU and rate-limit cache buckets without disturbing your credentials or chats.
How to fix "Agent terminated due to error" (write EIO broken pipe)?
Our Zero-Log ASAR shield intercepts verbose stdout/stderr write pipes to prevent buffer overflows, and enforces an aggressive 15-second TCP KeepAlive heartbeat to keep streaming inference alive across DPI middleboxes.
How to fix "proxyconnect tcp: dial tcp 127.0.0.1:10808: connect: connection refused"?
This happens when the proxy client is closed or on another port. Run antigravity-cleaner doctor to automatically probe active loopback ports (10808, 2080, 7890, 1080) and auto-align your IDE configuration.
Do you support Apple Silicon (M1/M2/M3/M4) Macs and Linux?
Yes. Native standalone binaries are available for macOS (Universal ARM64 & Intel), Linux (Ubuntu, Debian, Fedora, Arch), and Windows 10/11.
Can I restore the original files if Google updates Antigravity IDE?
Yes. Running antigravity-cleaner restore instantly rolls back all binaries and JavaScript files from automatic .agybak snapshots.