🚀 Antigravity CLI Manager (acm)

A lightweight, elegant Terminal UI (TUI) to manage and hot-swap Google Gemini account sessions for the agy CLI utility.

---

✨ Features

• 🎨 Retro Terminal UI: Clean interface built entirely in Bash with Unicode box frames, beautiful ASCII art, and ANSI colors.
• ⚡ Background Quota Sync: Automatically fetches Gemini API limits silently in the background on startup.
• ⭐ Best Account Indicator: Automatically calculates and highlights (★) the account with the highest remaining quota.
• 🛡️ Secure Design: Obfuscated credentials, secure environment variable handovers, and scoped temp handlers to eliminate shell injection surfaces.
• 🔐 OAuth Login Capturer: Auto-captures OAuth tokens directly from the browser flow and closes the login instance gracefully.
• ⚙️ Hot-Swapping: Switch active accounts in seconds and jump right into your next agy session.
• 🤖 Auto-Rotation Mode: Automatically swaps active profiles when the current one runs out of API quota.

🚀 Quick Start

Installation

git clone https://github.com/hiri-dev/antigravity-cli-manager.git
cd antigravity-cli-manager
./install.sh

To install the modular version (separate Bash UI and Python core helper):

./install.sh --modular

To launch the manager from anywhere, simply run:

acm

🤖 Auto-Rotation & CLI Wrapper

acm includes an automated rotation mode to automatically swap to the account with the highest remaining quota when your active session hits 0% quota.

Manual Rotation Trigger

You can force a check and swap at any time by running:

acm rotate

Execution Wrapper

Run any command (such as agy) via the acm run wrapper. It will automatically check your quota, swap to the best account if needed, and run your command:

acm run agy "Explain quantum computing in one sentence"

🕹️ Usage & Keybindings

Navigation in the acm TUI is designed to be quick and intuitive.

Key	Action
W / S	Navigate Up / Down
Enter	Launch the selected account in agy
d	Delete the highlighted account

⚙️ Configuration

acm supports a lightweight configuration file automatically generated at ~/.config/acm/config.json.

{
    "show_ascii_art": true,
    "timeout_seconds": 3
}

• show_ascii_art: Toggle the retro ASCII header (true/false) to save vertical terminal space.
• timeout_seconds: Network timeout threshold for background API quota checks.

📦 Requirements

• Bash 4.0+
• Python 3
• cURL
• agy (Antigravity CLI installed in your PATH)

---

Built with ☕ for power-users who hate hitting API limits.