agy~swap
Security & Privacy

Security Model: vault.json vs OS Keychain, AES-GCM Backups & Network Endpoints

Exact security guarantees of agy-swap: plaintext 0600 vault.json default, opt-in AGY_SWAP_VAULT=keychain, AES-GCM backups, SHA-256/512 verification, and exact network endpoints.

How Saved Tokens and Active Sessions Are Stored

We state storage details directly without vague claims:

Encrypted Backups, File Locking & Installer Checksums

Every Network Endpoint agy-swap Contacts

EndpointWhen Contacted
Google OAuth & Code Assist APIsAccount login (add), token refresh, verified email checks, and quota polling
GitHub Releasesagy-swap update and agy-swap doctor --refresh
agy-swap.aklkbqx.comFallback latest-version lookup during agy-swap update when GitHub is unreachable
DNS-over-HTTPS (1.1.1.1, 8.8.8.8, or AGY_SWAP_DOH_URL)Host lookup retry strictly after a TLS verification/connection error
Custom mirror / Go proxy / Google CLI downloadOnly when AGY_SWAP_RELEASE_MIRROR, Go fallback, or install-agy is explicitly used

Frequently Asked Questions

Does agy-swap send usage analytics, telemetry, or crash reports?

No. The binary sends zero telemetry and contacts no external analytics server.

Why is vault.json 0600 instead of encrypted by default?

Headless terminals and background --sync-session hooks cannot prompt for a master passphrase non-interactively. Storing tokens in user-only 0600 files keeps non-interactive automation working while AGY_SWAP_VAULT=keychain gives desktop users OS keyring storage.

How can I migrate from vault.json to OS Keychain?

Export AGY_SWAP_VAULT=keychain in your shell profile, run agy-swap account migrate, and run agy-swap doctor to confirm.

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