agy~swap
Reference

Complete agy-swap CLI Commands, TUI Shortcuts & Environment Variables

Full reference for every agy-swap subcommand, TUI keyboard and mouse shortcut, and AGY_SWAP_* environment variable across macOS, Linux, and Windows.

Install Commands

# 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

CLI Subcommands

CommandGroupDescription
agy-swap addAdd and switchSign in with Google in your browser and save the account, or pipe a token via --token -.
agy-swap switch <account>Add and switchSwitch the active agy CLI and (on macOS/Linux) Antigravity IDE session by email, alias, or slot.
agy-swap nextAdd and switchRefresh quotas and rotate to the next eligible account, optionally filtered by --family.
agy-swap listAdd and switchPrint saved accounts, status badges, and Gemini / Claude-GPT quota bars.
agy-swap statusInspect and verifyPrint the currently active account and session source.
agy-swap limitsInspect and verifyShow 5-hour and weekly quota windows, Argon panel, and local reserve thresholds.
agy-swap limit <set|clear>Inspect and verifySet or clear manual cooldown durations and reserve thresholds per model family.
agy-swap recommendInspect and verifyRank saved accounts using sticky, balanced, or round-robin policy rules.
agy-swap doctorInspect and verifyVerify local files, vault readability, agy wrapper installation, and network reachability.
agy-swap verify <account>Inspect and verifyOpen the Google verification URL for an account marked VERIFY.
agy-swap profileAutomateCreate named account policies with primary, reserve, and minimum quota threshold.
agy-swap run nowAutomateLaunch the configured CLI with the recommended or directory-bound account.
agy-swap statuslineAutomateRender or install compact prompt segments for Starship, tmux, or zsh.
agy-swap watchAutomatePoll quotas continuously and trigger threshold alerts.
agy-swap install-agyInstall, backup, updateDownload the official Google Antigravity CLI, verify SHA-512, and wire the session guard.
agy-swap backup exportInstall, backup, updateExport or import account metadata or AES-GCM encrypted credential archives.
agy-swap updateInstall, backup, updateDownload, verify SHA-256 checksums, and upgrade agy-swap.
agy-swap completionInstall, backup, updateGenerate shell completion scripts for bash, zsh, fish, or PowerShell.
agy-swap donate [--open]Install, backup, updatePrint the GitHub Sponsors URL or open it with --open.

Interactive TUI Keyboard & Mouse Shortcuts

Key / InputBehavior
↑↓Move selection across saved accounts (or press j/k and 1-9 for direct slots).
EnterOpen the single confirmation dialog and switch to the highlighted account.
/Filter accounts interactively by name or email.
rCancel any in-flight poll and force an immediate quota refresh.
Ctrl-KOpen the searchable Ctrl+K action palette for every TUI and CLI task.
?Toggle the full keyboard guide and GitHub Sponsors link.

Environment Variables

VariableEffect
AGY_SWAP_VAULTSet to keychain to store saved tokens in macOS Keychain, Windows Credential Manager, or Linux Secret Service; file forces vault.json.
AGY_SWAP_AGY_BINOverride the agy binary path inspected and wrapped by agy-swap.
AGY_SWAP_CA_BUNDLETrust a custom root CA PEM bundle behind corporate TLS inspection.
AGY_SWAP_RELEASE_MIRROROverride release download base URL for install.sh, install.ps1, and update.
AGY_SWAP_DOH_URLOverride DNS-over-HTTPS resolver queried after TLS failures.
AGY_SWAP_SKIP_SYNC=1Skip launcher session synchronization (used when isolating a separate HOME).
AGY_SWAP_REDUCED_MOTION=1Disable TUI transitions and animations.
AGY_SWAP_ASCII=1Force ASCII borders instead of Unicode box characters.
AGY_SWAP_MOUSE=0Disable TUI mouse hover, wheel, and split-divider dragging.
AGY_SWAP_QUOTA_DEBUG=1Print sanitized quota API diagnostics with agy-swap list --refresh.
AGY_SWAP_USER_AGENTOverride HTTP User-Agent sent to Google quota endpoints.

Frequently Asked Questions

Which agy-swap commands support JSON output?

Core inspection and automation commands including list, status, limits, recommend, next, and doctor support --json for scripting.

How do I inspect the difference between limits and limit?

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.

What minimum terminal size does the TUI support?

The responsive operator deck adapts down to 28x12 compact terminals and expands up to 160-column wide side-by-side layouts.

Try agy-swap in your terminal

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