Antigravity Manager

🚀 Professional multi-account manager for Google Gemini & Claude AI

--- ## 📖 Table of Contents - [Why Antigravity Manager?](#-why-antigravity-manager) - [Features](#-features) - [Screenshots](#-screenshots) - [Quick Start](#-quick-start) - [Tech Stack](#️-tech-stack) - [Development](#-development) - [Debugging Docs](#-debugging-docs) - [FAQ](#-faq) - [Contributing](#-contributing) - [License](#-license) --- ## ✨ Why Antigravity Manager? When using Antigravity IDE, have you ever encountered these problems? - 😫 Single account quota runs out quickly, requiring frequent manual switching - 🔄 Managing multiple Google/Claude accounts is cumbersome - 📊 Don't know how much quota is left on the current account - ⏰ Worried about missing quota reset times - 🔌 Need a reliable local API proxy for development tools **Antigravity Manager** is here to solve these problems! It's a professional Electron desktop app that helps you: - ✅ **Unlimited Account Pool** - Add any number of Google Gemini / Claude accounts - ✅ **Smart Auto-Switching** - Automatically switch to the next available account when quota is low or rate-limited - ✅ **Real-time Monitoring** - Visualize quota usage for all accounts - ✅ **Local API Proxy** - Built-in OpenAI/Anthropic compatible proxy server - ✅ **Secure Encryption** - AES-256-GCM encryption for sensitive data --- ## 🎯 Features

☁️ Cloud Account Pool

Add unlimited Google Gemini / Claude accounts via OAuth
Display avatar, email, status, and last used time
Real-time status monitoring (Active, Rate Limited, Expired)

📊 Real-time Quota Monitoring

Multi-model support: gemini-pro, claude-3-5-sonnet, etc.
Visual progress bars with color indicators
Auto & manual refresh capabilities

🔄 Intelligent Auto-Switching

Unlimited pool mode with smart backup selection
Auto-switch when quota < 5% or rate-limited
Background monitoring every 5 minutes

🔐 Security First

AES-256-GCM encryption for sensitive data
OS native credential manager integration
Auto migration of legacy plaintext data

💾 Account Backup

Capture snapshots of account state
Fast switching between saved accounts
View, organize, and delete snapshots

⚙️ Process Control

Auto-detect if Antigravity is running
Launch via URI protocol or executable
Graceful close or force kill

🔌 Local API Proxy

OpenAI & Anthropic API compatible
Configurable port and request timeout
Model mapping (e.g. Claude → Gemini)

🛠️ Developer Tools

Built-in cURL & Python code generation
Visual service status monitoring
One-click API Key regeneration

### Additional Features - **🖥️ System Tray** - Background mode with tray icon and right-click menu - **🔗 IDE Sync** - Automatically scan and import accounts from IDE's `state.vscdb` - **📦 Batch Operations** - Batch refresh and delete multiple accounts - **📤 JSON Export/Import** - Export and import account pools with schema validation and deduplication - **🔔 Desktop Notifications** - Configurable alerts when model quota drops below your threshold - **🌐 Per-Account Proxy** - Route individual accounts through their own HTTP/SOCKS5 proxy - **📊 Smart Sorting** - Sort accounts by recently used, overall quota, or specific model groups - **📋 Compact Layout** - Dense horizontal view to maximize visible accounts - **🌏 Internationalization** - Multi-language support (English / 中文 / Русский) - **🎨 Modern UI** - Built with React, TailwindCSS, and Shadcn UI --- ## 📸 Screenshots

Main Interface

Proxy Interface Settings Interface

--- ## � Quick Start ### Download Download the latest release for your platform from the [Releases](https://github.com/Draculabo/AntigravityManager/releases) page. | Platform | Download | |----------|----------| | Windows (x64/ARM64) | [.exe installer](https://github.com/Draculabo/AntigravityManager/releases/latest) | | macOS | [.dmg installer](https://github.com/Draculabo/AntigravityManager/releases/latest) | | Linux | [.deb / .rpm](https://github.com/Draculabo/AntigravityManager/releases/latest) | | NixOS / Nix | `nix run github:Draculabo/AntigravityManager` | ### ❄️ Nix Integration You can integrate Antigravity Manager into your Nix configuration using the provided flake. #### 🛠️ NixOS / Home Manager Add the flake to your `flake.nix` inputs: ```nix inputs = { nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable"; antigravity-manager.url = "github:Draculabo/AntigravityManager"; }; ``` To integrate with your system, add `antigravity-manager.overlays.default` to your `nixpkgs.overlays`. This ensures the package is correctly built against your own `nixpkgs` instance and respects your global configuration. ```nix # Add to your NixOS/Home Manager configuration { nixpkgs.overlays = [ inputs.antigravity-manager.overlays.default ]; # Antigravity Manager has an unfree license (cc-by-nc-sa-40) nixpkgs.config.allowUnfree = true; environment.systemPackages = [ pkgs.antigravity-manager ]; } ``` #### 💻 Development Shell If you're using the overlay above, you can simply add it to your `devShell`: ```nix devShells.default = pkgs.mkShell { packages = [ pkgs.antigravity-manager ]; }; ``` > [!NOTE] > Since the package is unfree, you **must** have `allowUnfree = true;` enabled in your `nixpkgs` configuration for it to evaluate correctly. ### Build from Source #### Prerequisites - Node.js v18 or higher - npm or yarn #### Steps ```bash # Clone the repository git clone https://github.com/Draculabo/AntigravityManager.git cd AntigravityManager # Install dependencies npm install # Start development npm start # Build for production npm run make ``` --- ## �🛠️ Tech Stack | Category | Technologies | |----------|-------------| | **Core** | [Electron](https://www.electronjs.org/), [React](https://react.dev/), [TypeScript](https://www.typescriptlang.org/) | | **Build Tool** | [Vite](https://vitejs.dev/) | | **Styling** | [TailwindCSS](https://tailwindcss.com/), [Shadcn UI](https://ui.shadcn.com/) | | **State** | [TanStack Query](https://tanstack.com/query/latest), [TanStack Router](https://tanstack.com/router/latest) | | **Database** | [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) | | **Testing** | [Vitest](https://vitest.dev/), [Playwright](https://playwright.dev/) | --- ## � Development ### Available Scripts | Command | Description | |---------|-------------| | `npm start` | Start the app in development mode | | `npm run lint` | Run ESLint to check for code issues | | `npm run format:write` | Format code with Prettier | | `npm run test:unit` | Run unit tests with Vitest | | `npm run test:e2e` | Run E2E tests with Playwright | | `npm run test:all` | Run all tests | | `npm run type-check` | Run TypeScript type checking | | `npm run make` | Build production packages | ### Project Structure ``` AntigravityManager/ ├── src/ │ ├── main.ts # Electron main process │ ├── preload.ts # Preload script │ ├── renderer/ # React renderer process │ ├── ipc/ # IPC communication handlers │ └── server/ # Built-in server ├── docs/ # Documentation and assets └── .github/ # GitHub configuration ``` --- ## 🔍 Debugging Docs If you want to inspect Antigravity or Antigravity Manager traffic with Proxyman, start here: - [Proxyman Installation and Basic Setup on Windows](docs/proxyman-install.md) - [Proxyman Debugging Guide for Antigravity and Antigravity Manager](docs/proxyman-debugging.md) --- ## ❓ FAQ

Q: The app won't start?

Please check: 1. Make sure all dependencies are installed: `npm install` 2. Check if Node.js version is >= 18 3. Try deleting `node_modules` and reinstalling

Q: Account login failed?

1. Ensure network connection is working 2. Try clearing app data and logging in again 3. Check if the account is restricted by Google/Claude

Q: macOS shows Keychain/Credential error and OAuth cannot be saved?

This is a common macOS security behavior, usually when the app is unsigned or run directly from Downloads. This is a **temporary workaround** for personal use: 1. Move the app to `/Applications` 2. Run the following commands in Terminal (repeat after every update) ```plaintext sudo xattr -dr com.apple.quarantine "/Applications/Antigravity Manager 2.app" codesign --force --deep --sign - "/Applications/Antigravity Manager 2.app" ``` Reopen the app and allow Keychain access if prompted.

Q: How to report issues or suggestions?

Please submit issues or suggestions via [GitHub Issues](https://github.com/Draculabo/AntigravityManager/issues).

--- ## 🌟 Star History

--- ## 🤝 Contributing Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details. We follow the [Contributor Covenant](CODE_OF_CONDUCT.md) Code of Conduct. --- ## 📄 License [CC BY-NC-SA 4.0](LICENSE) --- ## ⚠️ Disclaimer > [!WARNING] > **For Educational Purposes Only** > > This project is intended solely for educational and research purposes. It is provided "as-is" without any warranty. **Commercial use is strictly prohibited.** > > By using this software, you agree that you will not use it for any commercial purposes, and you are solely responsible for ensuring your use complies with all applicable laws and regulations. The authors and contributors are not responsible for any misuse or damages arising from the use of this software. ---

If this project helps you, please give it a ⭐ Star!