Switch Google Antigravity accounts from your terminal.

agy-swap shows saved accounts, quota snapshots, and the last refresh state before you switch the shared local Google Antigravity session. Saved account tokens stay in a private vault.json file readable only by your user; AGY_SWAP_VAULT=keychain keeps them in the OS credential store instead.

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 doctor automated 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.