About this project

agys (Antigravity Switcher) is a pure Go command-line utility that isolates and orchestrates multiple account profiles across the Google Antigravity ecosystem, including the Antigravity CLI (agy), Antigravity IDE, Antigravity 2.0 Desktop App (GUI), and Antigravity Remote Control. It also provides native integration with Herdr multi-agent workspaces. Each profile is strictly sandboxed under `~/.agys/profiles/<profile_name>/`, with dynamic `$HOME` routing to prevent auth token bleed, separate configs, and isolated quota tracking. This enables running multiple panes or IDE windows with different Google accounts simultaneously without session collisions. Key features include: - Real-time 5-hour and weekly quota HUD tracking across all configured accounts, with reset countdown timers. - Smart auto profile selection based on the best 5-hour Gemini quota, with custom priority weights. - System health diagnostics (`agys doctor`) auditing binaries, OAuth tokens, Keychain isolation, model discovery, and Herdr socket RPC. - Multi-profile MCP management to inspect and synchronize Model Context Protocol servers. - Session history search and resume with interactive prompt search and workspace grouping. - Parallel Antigravity IDE launches with isolated `--user-data-dir` storage. - Desktop App GUI switching with macOS Keychain OAuth synchronization. - Remote SSH execution with instant credential sync and reverse-tunneled API calls to bypass datacenter geo-blocking. - Headless Remote Control daemon management with dynamic port allocation. - AI-powered staged git commit generation using the best-quota profile. - Profile cloning, export/import, rename, and deletion utilities. - Shell completions for zsh, bash, fish, and powershell, plus alias generation. - In-place atomic self-upgrades. For Herdr users, agys provides a 3-row high-contrast sidebar telemetry showing active profile, context window usage, model ID, and dual 5H/weekly quotas. It uses a hybrid telemetry approach: turn-by-turn push via Antigravity `statusLine` hook streaming for instant context updates, and a passive 60-second polling watcher for reset countdowns and quota recovery. Installation is available via a one-liner shell installer or from source with Go 1.22+. The tool is cross-platform for macOS and Linux, with zero CGO dependencies.