Skip to content

Latest commit

 

History

173 Commits

Folders and files

Repository files navigation

🇺🇸 English • 🇮🇷 فارسی • 🇸🇦 العربية • 🇷🇺 Русский • 🇪🇸 Español • 🇹🇷 Türkçe • 🇨🇳 简体中文 • 🇵🇰 اردو

Antigravity Cleaner Logo

⚡ Antigravity Cleaner, Fixer & Patcher Pro (v5.4.3)

Autonomous Sanction Bypass, Zero-Telemetry Engine & Direct No-TUN Proxy Injector for Google Antigravity

Release Downloads Go Security Audit Telegram Community Tests Scan Speed Privacy

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

GitHub Stars   Telegram Support   GitHub Forks

🌟 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!


🚀 Quick Install (One-Liner)

Run the automated installer in seconds without manual compiling or system dependencies:

🐧 Linux & 🍎 macOS (Apple Silicon M1–M4 & Intel)

curl -fsSL https://raw.githubusercontent.com/tawroot/antigravity-cleaner/main/install.sh | bash

🪟 Windows (PowerShell)

irm https://raw.githubusercontent.com/tawroot/antigravity-cleaner/main/install.ps1 | iex

💻 Visual Interfaces: Retro KeyGen GUI & Terminal Dashboard

💾 Retro KeyGen Desktop GUI (v5.4.3)

Launch 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:

Antigravity Cleaner Retro KeyGen Desktop GUI v5.4.3

🖥️ Interactive Terminal TUI & Diagnostics Doctor

Run ag-cleaner in your terminal for an interactive Lipgloss dashboard, and select option 7 to run instant connectivity diagnostics:

Antigravity Cleaner Interactive TUI
Antigravity Cleaner Doctor Diagnostics

💾 Direct Portable Download (Zero Installation Required)

⚡ 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 on 127.0.0.1. Simply double-click:

🪟 Windows 🍎 macOS 🐧 Linux
🪟
Windows 10 & 11
64-bit Editions

Download Windows

⚡ Double-click .exe to launch GUI
🍎
Apple macOS
Apple Silicon & Intel CPUs

Download macOS ARM64

Download macOS x64
🐧
Linux Distros
Ubuntu, Debian, Fedora, Arch

Download Linux x64

Download Linux ARM64

⚡ What is Antigravity Cleaner, Fixer & Patcher?

Google Region Restriction Notice

Antigravity Cleaner, Fixer & Patcher 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)

🧬 Core Engineering Layers & Deep Patches

Target Layer Target Asset Modifications & Injected Hardening
1. MultiGate Core Binary language_server (Binary) Low-level IDA-pattern bytecode patch setting RAX+8 hasValidAuth = 1. Permanently unlocks cloud code execution gates across restricted territories.
2. IDE Frontend Sandbox main.js (JavaScript) Unlocks isGoogleInternal flag in Electron frontend, purges V8 code-cache, and neutralizes client eligibility checks.
3. Chat & Agent Sidebar workbench.desktop.main.js Unlocks client-side eligibility gates for conversations and assistant sidebars.
4. Zero-Log ASAR Shield app.asar (Archive) Silences broken pipe write EIO exceptions and captures verbose stream errors during inference.
5. VS Code Guard extension.js (Extension) Injects re-download guard and pins extension channel integrity.
6. Enterprise Wrapper Process Wrapper Injects 8 enterprise flags (--disable_telemetry=true, --allow_all_sidecars=true, etc.).
7. No-TUN Process Proxy TCP / SOCKS5 Injector Injects direct process-level loopback proxy routing (127.0.0.1:10808, :2080, :7890) with zero TUN adapter overhead.

📖 Deep Technical Whitepaper: For detailed assembly listings, memory pattern scanning benchmarks, and IDA decompilations, see docs/ARCHITECTURE.md.


🛠️ CLI Subcommands & Diagnostics

Antigravity Cleaner can be driven entirely via command line:

Command Category Description & Purpose
ag-cleaner Interactive Launch the interactive Bubbletea Terminal UI (TUI) menu.
ag-cleaner gui Interface Open the standalone Retro KeyGen GUI (Classic Win95 desktop window).
ag-cleaner doctor Diagnostics Run complete health audit, socket probe, and proxy port connectivity scan.
ag-cleaner doctor --verbose Diagnostics Deep diagnostic scan with verbose network traces and socket telemetry.
ag-cleaner patch all Patcher Surgically patch Core binary (hasValidAuth = 1), CLI, IDE frontend & ASAR shield.
ag-cleaner launch Launcher Launch Antigravity with smart process-level proxy injection (zero TUN mode).
ag-cleaner clean Cleaner Flush 16 temporary quota & rate-limit buckets without losing chat history.
ag-cleaner restore Recovery Atomically restore all original binaries from factory .agybak backups.
ag-cleaner kill Process Terminate all running Antigravity and orphaned language_server zombie processes.
ag-cleaner create-launcher Desktop Generate a standalone 1-click desktop shortcut with pre-configured proxy flags.

❓ Troubleshooting Clinic & FAQ

Below are quick solutions for common questions. For the complete, screenshot-backed 10-error forensic clinic, consult docs/TROUBLESHOOTING.md.

🛡️ Is Antigravity Cleaner safe to run?

Yes. Security is 100% auditable directly in source code:

  1. Fully Offline Execution: Cleaner requires zero internet access during patching and cleaning. It operates strictly on 127.0.0.1.
  2. Pure Go (Zero Dependencies): Single compiled binary without external runtime or dynamic Python imports.
  3. 100% Passing GitHub Security Audits: Continuous automated CodeQL and Govulncheck scans in .github/workflows/security.yml.
  4. Chat & Project Preservation: Preserves User/globalStorage and project files during quota flushes.
  5. Auditable Architecture: Documented in .github/SECURITY.md and docs/ARCHITECTURE.md.
⚡ What does Auto-Fix do and why does it stay permanent?

Clicking [Auto-Fix] or running ag-cleaner patch all:

  1. Sets RAX+8 hasValidAuth = 1 in language_server binary.
  2. Neutralizes eligibility gatekeepers in agy CLI.
  3. Unlocks isGoogleInternal in Electron main.js.
  4. Injects ASAR Shield to prevent write EIO pipe crashes.
  5. Injects 8 enterprise flags (--disable_telemetry=true, --allow_all_sidecars=true).
  6. Configures process proxy injection.
🔄 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 execute ag-cleaner restore to instantly restore factory files.
  • Zero Residue: Deleting the single executable completely uninstalls Cleaner from your system.
🔬 Common Error Signatures Quick Guide
  • Agent terminated due to error & write EIO: Run ag-cleaner patch all. The ASAR Shield silences pipe breaks and injects 15s TCP KeepAlive.
  • 403 Forbidden (/auth-success): Run ag-cleaner patch all to bypass OAuth edge blocks.
  • proxyconnect tcp: dial tcp 127.0.0.1:10808: connection refused: Run ag-cleaner doctor to auto-detect your active proxy port.
  • Failed to fetch / 429 Quota: Run ag-cleaner clean to flush transient buckets without touching chats.

👉 View Full Error Clinic with Screenshots in docs/TROUBLESHOOTING.md


📊 Live System Benchmarks & Comparison Matrix

⚡ Click to view Live System Benchmarks & Performance Audit
Metric Antigravity Cleaner Pro (v5.4.3) Standard Shell Script / Legacy Tool
Language & Engine Pure Go 1.22+ Native Binary Python 3 / Bash / Node.js wrapper
MultiGate Scan Speed 1.94 GB/s (100% In-Memory RAM) 40–80 MB/s (Disk-bound grep/sed)
Inode Swap Latency 0.0018s (Atomic POSIX Swap) Destructive inplace write (ETXTBSY)
16-Target Clean Latency 0.0021s 1.8–3.5s (Shell traversal)
Memory Footprint 8.2 MB RSS 85–180 MB RSS (Python/V8)
Telemetry & Outbound 0.00 KB (Zero-Telemetry Engine) Unaudited / External dependency calls
🥊 Click to view Feature Comparison Matrix
Feature Capability Antigravity Cleaner Pro Standard VPN (TUN Mode) Manual File Deletion
No-TUN Process Proxy ✅ Built-in Direct SOCKS5 Loopback ❌ Forces full-system TUN routing ❌ None
MultiGate Machine-Code Patch ✅ IDA Inode Pattern Swap ❌ Cannot bypass client gate ❌ None
Preserves Chats & Workspace ✅ 100% Preserved ➖ Not applicable ❌ Risk of wiping globalStorage
Zero-Log ASAR Shield (write EIO) ✅ Built-in Exception Guard ❌ Middlebox drops still trigger EIO ❌ None
1-Click Atomic Restore ✅ Instant (.agybak) ❌ Requires IDE reinstallation ❌ Manual backup needed
Auditable Offline Engine ✅ 100% Localhost (127.0.0.1) ⚠️ Remote VPN servers ➖ Manual

🤖 Autonomous AI Agent Skill (skills/antigravity-cleaner)

Antigravity 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 doctor on 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.

🔬 Multi-Ecosystem Applied AI Security Lab (Google DeepMind, OpenAI, Anthropic, Cursor)

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!

🚦 Standard Bug & Issue Reporting Pathway

To ensure rapid triage and resolution:

  1. Interactive GitHub Issue Forms: If you experience an edge case, please open an issue using our structured Bug Report Form.
  2. Community Q&A & Proxy Setups: For general questions, VPN configurations, and advice, use GitHub Discussions.
  3. Security Vulnerabilities: Follow our SECURITY.md guidelines and report privately via GitHub Security Advisories.

👥 Credits & Attribution

  • 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.

🗺️ Project Roadmap

Curious about upcoming features, standard error normalizers, and laboratory prototypes?
Check out our official ROADMAP.md (or 🇮🇷 Persian Roadmap) for planned milestones.


📈 Star History

If this tool unblocked your workflow, a ⭐ star helps other developers discover it.

Star History Chart

💬 Community & Discussions

Questions, feature requests, or want to share your setup? Open a Discussion →

Releases

Packages

Used by

Contributors

Languages