Which agy-swap commands support JSON output?
Core inspection and automation commands including list, status, limits, recommend, next, and doctor support --json for scripting.
Full reference for every agy-swap subcommand, TUI keyboard and mouse shortcut, and AGY_SWAP_* environment variable across macOS, Linux, and Windows.
# macOS / Linux (Shell, verifies SHA-256)
curl -fsSL --proto '=https' --tlsv1.2 https://agy-swap.aklkbqx.com/install.sh | bash
# Homebrew (macOS / Linux)
brew install aklkbqx/agy-swap/agy-swap
# Windows PowerShell (verifies SHA-256)
irm https://agy-swap.aklkbqx.com/install.ps1 | iex
# From source (Go 1.27.4+)
go install github.com/aklkbqx/agy-swap/v2/cmd/agy-swap@latest
| Command | Group | Description |
|---|---|---|
agy-swap add | Add and switch | Sign in with Google in your browser and save the account, or pipe a token via --token -. |
agy-swap switch <account> | Add and switch | Switch the active agy CLI and (on macOS/Linux) Antigravity IDE session by email, alias, or slot. |
agy-swap next | Add and switch | Refresh quotas and rotate to the next eligible account, optionally filtered by --family. |
agy-swap list | Add and switch | Print saved accounts, status badges, and Gemini / Claude-GPT quota bars. |
agy-swap status | Inspect and verify | Print the currently active account and session source. |
agy-swap limits | Inspect and verify | Show 5-hour and weekly quota windows, Argon panel, and local reserve thresholds. |
agy-swap limit <set|clear> | Inspect and verify | Set or clear manual cooldown durations and reserve thresholds per model family. |
agy-swap recommend | Inspect and verify | Rank saved accounts using sticky, balanced, or round-robin policy rules. |
agy-swap doctor | Inspect and verify | Verify local files, vault readability, agy wrapper installation, and network reachability. |
agy-swap verify <account> | Inspect and verify | Open the Google verification URL for an account marked VERIFY. |
agy-swap profile | Automate | Create named account policies with primary, reserve, and minimum quota threshold. |
agy-swap run now | Automate | Launch the configured CLI with the recommended or directory-bound account. |
agy-swap statusline | Automate | Render or install compact prompt segments for Starship, tmux, or zsh. |
agy-swap watch | Automate | Poll quotas continuously and trigger threshold alerts. |
agy-swap install-agy | Install, backup, update | Download the official Google Antigravity CLI, verify SHA-512, and wire the session guard. |
agy-swap backup export | Install, backup, update | Export or import account metadata or AES-GCM encrypted credential archives. |
agy-swap update | Install, backup, update | Download, verify SHA-256 checksums, and upgrade agy-swap. |
agy-swap completion | Install, backup, update | Generate shell completion scripts for bash, zsh, fish, or PowerShell. |
agy-swap donate [--open] | Install, backup, update | Print the GitHub Sponsors URL or open it with --open. |
| Key / Input | Behavior |
|---|---|
↑↓ | Move selection across saved accounts (or press j/k and 1-9 for direct slots). |
Enter | Open the single confirmation dialog and switch to the highlighted account. |
/ | Filter accounts interactively by name or email. |
r | Cancel any in-flight poll and force an immediate quota refresh. |
Ctrl-K | Open the searchable Ctrl+K action palette for every TUI and CLI task. |
? | Toggle the full keyboard guide and GitHub Sponsors link. |
| Variable | Effect |
|---|---|
AGY_SWAP_VAULT | Set to keychain to store saved tokens in macOS Keychain, Windows Credential Manager, or Linux Secret Service; file forces vault.json. |
AGY_SWAP_AGY_BIN | Override the agy binary path inspected and wrapped by agy-swap. |
AGY_SWAP_CA_BUNDLE | Trust a custom root CA PEM bundle behind corporate TLS inspection. |
AGY_SWAP_RELEASE_MIRROR | Override release download base URL for install.sh, install.ps1, and update. |
AGY_SWAP_DOH_URL | Override DNS-over-HTTPS resolver queried after TLS failures. |
AGY_SWAP_SKIP_SYNC=1 | Skip launcher session synchronization (used when isolating a separate HOME). |
AGY_SWAP_REDUCED_MOTION=1 | Disable TUI transitions and animations. |
AGY_SWAP_ASCII=1 | Force ASCII borders instead of Unicode box characters. |
AGY_SWAP_MOUSE=0 | Disable TUI mouse hover, wheel, and split-divider dragging. |
AGY_SWAP_QUOTA_DEBUG=1 | Print sanitized quota API diagnostics with agy-swap list --refresh. |
AGY_SWAP_USER_AGENT | Override HTTP User-Agent sent to Google quota endpoints. |
Core inspection and automation commands including list, status, limits, recommend, next, and doctor support --json for scripting.
agy-swap limits reads and optionally refreshes quota bars for every account, while agy-swap limit set|clear configures manual cooldowns or reserve thresholds on one account.
The responsive operator deck adapts down to 28x12 compact terminals and expands up to 160-column wide side-by-side layouts.
Install with Homebrew, shell, PowerShell, or Go source, then save your accounts and inspect live quotas locally.
brew install aklkbqx/agy-swap/agy-swap
curl -fsSL --proto '=https' --tlsv1.2 https://agy-swap.aklkbqx.com/install.sh | bash