From install to your first switch
Choose your system on the install page, run agy-swap add to save an account, then run agy-swap to inspect and switch accounts.
# macOS / Linux
curl -fsSL --proto '=https' --tlsv1.2 https://raw.githubusercontent.com/aklkbqx/agy-swap/main/install.sh | bash
# Go (Any Platform)
go install github.com/aklkbqx/agy-swap/v2/cmd/agy-swap@latest
# Windows PowerShell
irm https://raw.githubusercontent.com/aklkbqx/agy-swap/main/install.ps1 | iex
Key Features & Architecture
- Account Switching: One switch moves the agy CLI and, on macOS and Linux, the Antigravity IDE to the account you pick.
- Quota Snapshots: See remaining capacity and reset times, then refresh before relying on older data.
- Credential Storage: Saved account tokens stay in a private vault.json file readable only by your user; set AGY_SWAP_VAULT=keychain to use macOS Keychain, Windows Credential Manager, or Linux Secret Service instead.
- Adaptive Terminal UI (TUI): Full interactive terminal interface with Command Palette (
Ctrl-K/:). - System Doctor Diagnostics:
agy-swap doctorautomated health verification in one command.
CLI Quick Reference
agy-swap # Launch interactive TUI
agy-swap add # Connect a new account via OAuth browser flow
agy-swap switch 1 # Switch active account by index
agy-swap switch <email> # Switch active account by email
agy-swap next # Auto-switch to next account with available quota
agy-swap limits # View saved quota and cooldown breakdown
agy-swap doctor # Run comprehensive system diagnostics
Frequently Asked Questions
What is agy-swap?
agy-swap is a local Go CLI for people using multiple Google Antigravity accounts. It shows account health and saved quota data, then switches the shared local session.
How do I switch Google Antigravity accounts?
You can run agy-swap to open the interactive terminal UI, or execute agy-swap switch <email> directly from your terminal or shell scripts.