🇺🇸 English • 🇮🇷 فارسی • 🇸🇦 العربية • 🇷🇺 Русский • 🇪🇸 Español • 🇹🇷 Türkçe • 🇨🇳 简体中文 • 🇵🇰 اردو
Autonomous Sanction Bypass, Zero-Telemetry Engine & Direct No-TUN Proxy Injector for Google Antigravity
Dedicated from the heart to every human being, child, student, teacher, creator, and independent developer striving for learning and growth — especially those caught between domestic filtering from within and digital sanctions from without. Across 🇰🇵 North Korea, 🇮🇷 Iran, 🇨🇳 China, 🇷🇺 Russia, 🇹🇷 Turkey, 🇨🇺 Cuba, 🇸🇾 Syria, 🇧🇾 Belarus, 🇸🇩 Sudan, 🇻🇪 Venezuela, 🇦🇫 Afghanistan, 🇲🇲 Myanmar, and every developing corner of our world. Artificial intelligence is the collective heritage of humanity. Access to knowledge, education, and AI is a fundamental human right for all people, not a privilege reserved for wealthy borders.
— @dalroot
🌟 Support Open Access to AI:
If Antigravity Cleaner helped you bypass Google sanctions or fix quota errors, please Star this repo — it helps restricted developers discover this tool!
- 💾 Direct Portable Download (Zero Install)
- ⚡ What is Antigravity Cleaner?
- 🧬 Core Engineering Layers & Deep Patches
- 🧭 Step-by-Step Setup & Google Account Region Check
- ❓ FAQ, Security & Visual Error Troubleshooting
- 🏛️ System Architecture & Traffic Flow
- 🛡️ Zero-Telemetry Engine & Privacy Guarantee
- 📊 Live System Benchmarks & Audit Logs
- 🥊 Comprehensive Comparison Matrix (v5.4.0)
- 🚀 Quick CLI Install (One-Liner)
- 💻 Visual Interfaces: Retro KeyGen GUI & Terminal Dashboard
- 🛠️ CLI Subcommands & Diagnostics
- 🤖 Autonomous AI Agent Skill
- 🔬 Multi-Ecosystem Applied AI Security Lab
- 🚦 Standard Bug & Issue Reporting Pathway
- 👥 Credits & Attribution
⚡ Technical Binary Specifications:
Compiled in pure Go (Go 1.22+); 100% standalone and portable (no Python or external runtime needed), fully offline, requiring no root privileges or terminal setup, executing strictly locally on127.0.0.1. Simply double-click:
| 🪟 Windows | 🍎 macOS | 🐧 Linux |
|---|---|---|
|
🪟 Windows 10 & 11 64-bit Editions -0078D6?style=for-the-badge&logo=windows&logoColor=white){kind=icon}
⚡ Double-click .exe to launch GUI |
🍎 Apple macOS Apple Silicon & Intel CPUs 
-gray?style=for-the-badge&logo=apple&logoColor=white){kind=icon}
|
🐧 Linux Distros Ubuntu, Debian, Fedora, Arch -FCC624?style=for-the-badge&logo=linux&logoColor=black){kind=icon}
-FCC624?style=for-the-badge&logo=linux&logoColor=black){kind=icon}
|
Antigravity Cleaner Pro is a specialized, open-source systems utility engineered in pure Go that neutralizes region blocking, account eligibility barriers, telemetry phone-home beacons, and HTTP 429 quota locks across:
- Google Antigravity 2.x
- Antigravity IDE
- Antigravity CLI (
agy) - Official VS Code Extension (
google.google-antigravity)
Antigravity IDE is built on an Electron / VS Code frontend, but all core AI capabilities, semantic reasoning, Gemini communication, quota arbitration, license checking, and sanction/geoblocking enforcement are handled by a dedicated compiled binary named language_server.
On startup and during streaming, Google inspects real IP addresses, timezones, and telemetry beacons through this binary to sever AI connections for sanctioned nations (Iran, Cuba, Syria, etc.). Patching this binary gate is the cornerstone of liberating the IDE.
🔍 Click to inspect all 9 technical layers:
- Core Engine Binary Neutralization (
language_server) & Universal Discovery
Dynamically detects and scans target binaries across all architecture variants (Apple Siliconarm64, Intelx64, Linuxaarch64/amd64, and Google RPM/DEB layouts) without hardcoded paths, rewriting authentication logic directly in machine code (RAX+8 hasValidAuth = true) to permanently eliminate 403 blocks andUser location is not supportederrors. - CLI Eligibility Bypass (
agy)
Neutralizes client-side regional and eligibility gating in the official command-line executable. - IDE Frontend Capability Unlock (
main.js)
Activates theisGoogleInternalflag in the Electron frontend, granting preview features and agent toolkits, while flushing stale V8 compile caches. - Zero-Log & EIO Shield (
app.asar)
Silences verbose Google telemetry logging (level: 'silly'changed tolevel: false) and handles broken console pipe errors (Broken pipe / write EIO) to prevent stream crashes. - Anti Re-Download Guard
Locks the extension update channel and suppresses hash re-checks, preventing the IDE from silently overwriting your patched binaries. - Enterprise Wrapper (8-Flag Runtime)
Wraps the core binary with 8 production flags, enforcing--disable_telemetry=trueand unlocking MCP servers with--allow_all_sidecars=true. - 100% Privacy Protection & Data Isolation
Stops all background exfiltration of prompts, terminal command histories, git commits, session IDs, and real IP addresses. Runs strictly locally on127.0.0.1. - Surgical HTTP 429 Quota Reset
Instantly purges corrupted rate-limit cookies and token buckets across 16 targets in 0.002 seconds without touching project files or conversation history. - Direct No-TUN Smart Proxy Injector
Routes IDE traffic directly to local proxies (Xray, Clash, Sing-box, Hiddify) on ports 10808 / 7890 without requiring full-system TUN mode, backed by 15s TCP KeepAlive socket tuning against DPI drops.
Tip
All modifications and patches are 100% reversible.
Before altering a single byte, Cleaner automatically creates an untouched factory backup with the .agybak extension. You can revert everything to virgin state at any time:
- In Retro GUI: Click the
[Restore]button. - In Terminal CLI: Run
ag-cleaner restore.
Google assigns region restrictions based on account history:
👉 Check your country association in 30 seconds:
Google Country Association Form
- If country shows a supported region (US, Germany, etc.): Your account is ready.
- If country shows a sanctioned region:
- Option A (Update Country): Turn on your VPN, reopen the form, check
I frequently use a Virtual Private Network (VPN), and click Submit. - Option B (Fresh Account): Register a fresh Gmail account while connected to your VPN.
- Option A (Update Country): Turn on your VPN, reopen the form, check
Once your account region is verified, launching Cleaner is available through two straightforward pathways (Graphical Window or Terminal Console):
Simply double-click the standalone executable to launch the nostalgic GUI window. The workflow is an intuitive, automated 3-step sequence:
- Step 1 — Click
[ ① ⚡ Auto-Fix ]:
Click the button and wait a couple of seconds. Cleaner automatically patches the core engine, CLI, IDE frontend, extension guard, and Zero-Log ASAR shield. Upon completion, the status box displays✔ STEP 1 DONE! Next: Click [ ② 🚀 Launch IDE ]in green and activates the second step button. - Step 2 — Click
[ ② 🚀 Launch IDE ]:
Launches Google Antigravity with smart direct proxy injection (bypassing the need for whole-system TUN mode). The IDE is instantly ready with full AI capabilities. - Step 3 — Click
[ ③ 📌 Shortcut ]:
Creates 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 reopening Cleaner!
If you prefer working in a command-line environment:
- Interactive Fullscreen TUI:
Runantigravity(orag-cleaner) to open the interactive Lipgloss dashboard. Select option1(Auto-Fix). Cleaner will verify every component and confirm with a green🎉 AUTO-FIX COMPLETED SUCCESSFULLY!box. - Direct Scriptable Commands:
- Windows (CMD or PowerShell):
# 1. Apply all patches and auto-generate proxy launcher antigravity-cleaner.exe patch all # 2. Launch Antigravity directly with smart No-TUN proxy antigravity-cleaner.exe launch # 3. (Optional) Create permanent desktop shortcut antigravity-cleaner.exe create-launcher
- Linux & macOS (Terminal):
# 1. Apply all patches and auto-generate proxy launcher ./antigravity-cleaner patch all # 2. Launch Antigravity directly with smart No-TUN proxy ./antigravity-cleaner launch # 3. (Optional) Create permanent desktop shortcut ./antigravity-cleaner create-launcher
- Windows (CMD or PowerShell):
🛡️ Is Antigravity Cleaner safe to run?
Yes. Security is 100% auditable directly in source code:
- Fully Offline Execution: Cleaner requires zero internet access during patching and cleaning. It operates strictly on
127.0.0.1. - Pure Go (Zero Dependencies): Single compiled binary without shady DLLs or dynamic Python imports.
- 100% Passing GitHub Security Audits: Continuous automated CodeQL and Govulncheck scans in
.github/workflows/security.yml. - Chat & Project Preservation: Preserves
User/globalStorageand project files during quota flushes. - Auditable Architecture: Documented in
.github/SECURITY.mdanddocs/ARCHITECTURE.md.
⚡ What does Auto-Fix do and why does it stay permanent?
Clicking [Auto-Fix] or running ag-cleaner patch all:
- Core Engine: Machine-code patch sets
RAX+8 hasValidAuth = 1(pkg/patcher/manager.go). - CLI (
agy): Neutralizes eligibility gates (pkg/patcher/cli.go). - IDE (
main.js): UnlocksisGoogleInternaland purges V8 cache (pkg/patcher/ide.go). - VS Code Extension: Injects re-download guard (
pkg/patcher/vscode.go). - ASAR Shield: Silences verbose logging and captures
write EIOpipe errors (pkg/patcher/asar.go). - Enterprise Wrapper: Injects 8 flags (
--disable_telemetry=true,--allow_all_sidecars=true) (pkg/patcher/flags.go). - No-TUN Proxy Launcher: Injects local proxy routing without root TUN mode (
pkg/proxy/launcher.go).
🔄 How does automated backup and restore work?
- Factory Backup (
.agybak): Backs up pristine binaries before applying any changes (pkg/patcher/atomic.go). - 1-Click Factory Reset: Click
[Restore]or executeag-cleaner restoreto instantly restore factory files. - Zero Residue: Deleting the single executable completely uninstalls Cleaner from your system.
1. Agent Terminated Due to Error (write EIO / Pipe Failure)
Agent terminated due to error
You can prompt the model to try again or start a new conversation if the error persists.
See our troubleshooting guide for more help.
Dismiss Copy debug info Retry
- Cause: Sudden pipe breakdown caused by verbose raw logging (
write EIO) or middlebox connection timeouts during streaming. - Fix: Click
[Auto-Fix]; the ASAR Zero-Log Shield silences broken pipe exceptions and enables 15s TCP KeepAlive heartbeat socket tuning.
2. Network Issue Connecting to Server (Unknown Error ID)
Worked for 1s >
Error Unknown: There was a network issue connecting to the server, please try again. ˅
Error ID: 95ea05dd-6419-4bf0-a8ce-8faf25687606-108
Unknown: There was a network issue connecting to the server, please try again.
12:24 AM
- Cause: Deep Packet Inspection (DPI) 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.
3. Authentication Gating / 403 Forbidden (/auth-success)
Google
403. That’s an error.
Your client does not have permission to get URL /auth-success from this server. That’s all we know.
- Cause: Google regional check flagging browser login redirect from sanctioned regions.
- Fix: Run
[Auto-Fix]; setshasValidAuth = true, passes--stubby_auth_mode=business_licensed_enterprise, and clears poisoned auth tokens.
4. Proxy Connection Refused (dial tcp 127.0.0.1:10808)
There was an unexpected issue setting up your account.
failed to get load code assist response: Post "https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist": proxyconnect tcp: dial tcp 127.0.0.1:10808: connect: connection refused
Continue with different account
Having trouble? Let us know
- Cause: Local proxy client (Xray, Clash, NekoBox) is closed or listening on a different port.
- Fix: Run
ag-cleaner doctor; automatically scans open local ports and updates proxy configuration.
5. Initial Account Setup Failed (Failed to fetch)
There was an unexpected issue setting up your account.
Failed to fetch
Continue with different account
Having trouble? Let us know
- Cause: Corrupted DIPS database records and orphaned WebSocket caches in application state.
- Fix: Run
ag-cleaner clean(or click Clean 429 in GUI); flushes 16 cached quota artifacts in 0.002s while protecting chat history.
6. macOS App Management / Operation Not Permitted (syscall.EPERM)
- Cause: macOS Ventura, Sonoma, and Sequoia enforce strict App Management sandboxing preventing external CLI tools from modifying signed application bundles inside
/Applications/Antigravity.app. - Fix:
- Open System Settings ➔ Privacy & Security ➔ App Management.
- Toggle ON the permission switch for your terminal application (Terminal, iTerm2, Kitty, Ghostty, or VS Code).
- Re-run
./antigravity-cleaner patch all. Pre-flight canary checks in Cleaner v5.4.0 will verify write permissions and complete the patch.
graph LR
IDE["💻 Antigravity IDE / agy CLI"]
CLEANER["⚡ Antigravity Cleaner Pro<br>(Bytecode Patch + Zero-Telemetry + No-TUN Injection)"]
PROXY["🛡️ Local Proxy Client<br>(Xray / Clash / Sing-box / Hiddify)"]
GOOGLE["☁️ Google Cloud Mesh<br>(Gemini AI & Cloud Code)"]
IDE -->|Auto-Routed Traffic| CLEANER
CLEANER -->|Direct SOCKS5h Socket| PROXY
PROXY -->|Uninterrupted Stream| GOOGLE
By default, Google Antigravity continuously transmits background telemetry packets to Google endpoints (googleapis.com, cloudcode-pa.googleapis.com):
- Real IP & Geolocation Leaks: Telemetry probes report local unmasked network latency and IP profile, causing
User location is not supportedblocks. - Git Metadata & Workspace Surveillance: Reports commit hashes, repository remotes, and file extensions.
- Error & Crash Beacons: Diagnostic traces broadcast error states to Google Cloud Code logging services.
With our 8-Flag Zero-Telemetry Engine:
- 100% Severed Phone-Home Channels: Automatically injects
--disable_telemetry=trueand enterprise isolation flags into the core binary runtime. Google receives zero telemetry packets, zero git metadata, and zero IP trace beacons from your machine. - 100% Local Execution: Operates entirely locally on
127.0.0.1with zero external network requests. - 100% Conversation Preservation: The surgical quota reset (
ag-cleaner clean) targets only corrupt rate-limit cookies and DIPS caches. Prompts and project histories are strictly preserved. - POSIX Atomic Safety: Core binaries are modified using atomic inode replacement (
os.Rename), ensuring running processes never crash or lock withETXTBSY.
| Metric | Measured Value | Verification Log |
|---|---|---|
| In-Memory Pattern Scanning | 1,901.84 MB/s (~1.9 GB/s) | benchmarks.log |
| 171MB Binary Patch Duration | 0.23 seconds | benchmarks.log |
| Doctor Concurrent Audit | ~2.5 seconds | live_system_test.log |
| Surgical 429 Cache Flush | 16 artifacts purged (0 chat loss) | live_system_test.log |
| Unit Test Pass Rate | 100% (All packages passing) | benchmarks.log |
Note
All benchmarks reflect live instrumentation on official test suites. Actual speeds may vary based on CPU and NVMe storage throughput. Because operations occur atomically in memory, patching completes in fractions of a second with zero UI frame drops.
| Feature | Single-Purpose Patchers (open-antigravity-patcher, QNIX) |
Process/DLL Injectors (antigravity-proxy) |
⚡ Antigravity Cleaner Pro (v5.4.0) |
|---|---|---|---|
| Language & Architecture | Python 3 (requires runtime, pip) |
Windows-only C++ / DLL injection | Native Pure Go (Zero dependencies, Single Executable) |
| User Interface | Basic text stdout | Basic console | Win95 Retro Desktop GUI + 2026 Lipgloss TUI Dashboard |
| No-TUN Proxy Launcher | ❌ (Forces root TUN mode) | ❌ None | ✅ Auto-detects Xray/Clash/NekoBox & Injects |
Zero-Log ASAR Shield (write EIO) |
❌ None | ❌ None | ✅ Silences broken pipe crashes in app.asar |
| Stream KeepAlive Tuner | ❌ (Frequent stream drops) | ❌ None | ✅ Enforces 15s TCP KeepAlive socket tuning |
| Surgical 429 Quota Reset | ❌ (Wipes entire config & chats) | ❌ (Deletes everything) | ✅ Cleans token cache, PRESERVES all chats! |
| Core Binary Patch | x86_64 / ARM64 | ❌ None | ✅ MultiGate IDA-style machine-code patch |
IDE Frontend Patch (main.js) |
✅ Basic regex | ❌ None | ✅ Automated patch + V8 compile cache purge |
| Anti Re-Download Guard | ✅ Basic | ❌ None | ✅ Full Guard + Channel Lock |
| Diagnostic Doctor Tool | ❌ None | ✅ Concurrent 2s latency & DNS leak probe | |
| POSIX Atomic Replacement | Python tempfile | ❌ None | ✅ Atomic Inode swap (no ETXTBSY on running app) |
curl -fsSL https://raw.githubusercontent.com/tawroot/antigravity-cleaner/main/install.sh | bashirm https://raw.githubusercontent.com/tawroot/antigravity-cleaner/main/install.ps1 | iexLaunch standalone or with ag-cleaner gui for a 3-step workflow (① Auto-Fix ➔ ② Launch IDE ➔ ③ Shortcut), real-time Zero-Telemetry toggle, and live process monitoring:
Run ag-cleaner in your terminal for an interactive Lipgloss dashboard, and select option 7 to run instant connectivity diagnostics:
# Launch interactive menu
ag-cleaner
# Launch Retro KeyGen GUI (Classic Win95 Desktop Window)
ag-cleaner gui
# Health & latency diagnostics (clean card)
ag-cleaner doctor
# Detailed diagnostics with debug traces
ag-cleaner doctor --verbose
# Apply all patches (Core binary, CLI, IDE frontend, ASAR shield)
ag-cleaner patch all
# Launch Antigravity with smart proxy injection (No TUN mode needed!)
ag-cleaner launch
# Reset HTTP 429 Quota without losing conversation history
ag-cleaner clean
# Restore all binaries to original factory state
ag-cleaner restore
# Terminate all running Antigravity & language_server zombie processes
ag-cleaner kill
# Generate desktop shortcut with pre-configured proxy
ag-cleaner create-launcher
# View project attribution & credits
ag-cleaner aboutAntigravity Cleaner provides a native Agent Skill (skills/antigravity-cleaner/SKILL.md) that enables AI coding assistants (Google Antigravity, Claude Code, Cursor, Codex) to self-heal their environment when encountering API restrictions, quota limits, or network timeouts:
- Automated Self-Audit: Agents trigger
ag-cleaner doctoron connection loss. - Autonomous Quota Healing: Agents run surgical clean on HTTP 429 without human intervention.
- Zero Configuration: Vendored directly inside the project root for automatic discovery.
Behind Antigravity Cleaner Pro stands an active reverse-engineering and security research initiative. In our private security research laboratory, we systematically deconstruct and analyze developer tools across the global AI ecosystem: Google DeepMind (Antigravity & Gemini), OpenAI, Anthropic (Claude Code), and Cursor.
- 100+ Internal Patches & Protocol Bridges: Our private laboratory repository maintains a library of over 100+ low-level bytecode patches, telemetry nullifiers, Stubby RPC bridges, and BYOM (Bring-Your-Own-Model) connectors.
- Foundational Flagship Release: Antigravity Cleaner Pro serves as the foundational flagship project of this initiative, with subsequent specialized tools planned for release across other AI developer stacks.
- Production Hardening Pipeline: Advanced research findings undergo extensive fuzzing and compatibility testing across Windows, macOS, and Linux before being safely graduated into public open-source releases.
- Global Developer Backing: This is a battle-tested engineering project dedicated to providing long-term reliability for developers facing digital isolation and network restrictions.
- Support the Project: If our work keeps your IDE online and productive, please star this repository ⭐. Your community engagement directly accelerates public releases from our private laboratory!
To ensure rapid triage and resolution:
- Interactive GitHub Issue Forms: If you experience an edge case, please open an issue using our structured Bug Report Form.
- Community Q&A & Proxy Setups: For general questions, VPN configurations, and advice, use GitHub Discussions.
- Security Vulnerabilities: Follow our SECURITY.md guidelines and report privately via GitHub Security Advisories.
- Lead Architect & Maintainer: @dalroot
- Co-Pilot & Pair Programming: Antigravity AI (Google DeepMind) — Crafted in creative pair-programming using Google's own AI agent to liberate Google's developer tools for restricted coders worldwide! 🤖
- License: Apache License 2.0 (Apache-2.0)
- Dedicated to uncensored technology, open-source accessibility, and developer freedom everywhere.
Curious about upcoming features, standard error normalizers, and laboratory prototypes?
Check out our official ROADMAP.md (or 🇮🇷 Persian Roadmap) for planned milestones.
If this tool unblocked your workflow, a ⭐ star helps other developers discover it.
Questions, feature requests, or want to share your setup? Open a Discussion →