安装、添加账号、打开。
# macOS / Linux (Shell, 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 (SHA-256)
irm https://agy-swap.aklkbqx.com/install.ps1 | iex
# Corporate TLS proxy
curl -k -fsSL https://agy-swap.aklkbqx.com/install.sh | AGY_SWAP_INSECURE=1 bash
# 源码
go install github.com/aklkbqx/agy-swap/v2/cmd/agy-swap@latest
开发者为什么选择 agy-swap
- CLI 与 IDE 同步切换: 一次切换即可更新 agy CLI、macOS/Linux 上的 Antigravity IDE 及 Jetski 会话,并配有文件锁与自动回滚保护。
- 实时模型配额与重置倒计时: 清晰显示 Gemini、Claude/GPT 的 5 小时与每周配额池以及每周 Gemini 4 Argon 配额池的剩余比例与本地重置时间。
- 会话守卫防止令牌覆盖: 其他目录中运行的 agy 进程在后台刷新 OAuth 令牌时,会按刷新令牌回收回对应的 vault 记录,不会覆盖当前选中账号。
- 目录配置绑定与并行终端: 使用 profile 和 bind 按项目绑定策略,用 next --family 自动轮换,或用独立 HOME 与 AGY_SWAP_SKIP_SYNC=1 同时运行两个 CLI。
- 一键安装官方 CLI 与状态栏: 运行 agy-swap install-agy 校验 SHA-512 并安装官方 agy,使用 agy-swap statusline 在 Starship、tmux 或 zsh 中显示配额。
- 本地凭证存储与加密备份: 令牌默认存放在 vault.json(0600,未加密)或通过 AGY_SWAP_VAULT=keychain 存入系统密钥库,并支持 AES-GCM 加密导出备份。
- 查看所有已保存账号。 一个列表,每个账号一行。蓝色圆点和 ACTIVE 字样表示 Antigravity 当前使用的账号。
- 看看还剩多少。 选中一行即可查看配额和重置时间。配额在后台自动更新:正在使用的账号每 20 秒,其他账号每 2 分钟,重置后立即更新;过旧的数字会注明更新时间。
- 按 Enter,再选 Switch。 agy-swap 会先确认。选择 Switch 后,agy CLI 以及(在 macOS 和 Linux 上的)Antigravity IDE 会使用你选的账号。更新有锁和回滚保护。
CLI 快速参考
agy-swap add # 用 Google 登录并保存账号。
agy-swap switch <account> # 通过邮箱、别名或序号切换。
agy-swap next # 先刷新,再切换到下一个还有配额的账号。
agy-swap list # 列出已保存账号及其状态和配额健康度。
agy-swap status # 显示当前使用的账号。
agy-swap limits # 显示所有账号的配额与本地预留阈值。
agy-swap limit <set|clear> # 为单个账号设置或清除手动冷却时间与预留阈值。
agy-swap recommend # 说明现在使用哪个账号最安全。
agy-swap doctor # 检查存储、凭据、保管库和平台就绪情况。
agy-swap verify <account> # 为需要验证的账号打开 Google 验证页面。
agy-swap profile # 定义配置文件,再用 bind 把目录绑定到它。
agy-swap run now # 用正确的账号启动已配置的 CLI。
agy-swap statusline # 输出或安装用于提示符的状态栏。
agy-swap watch # 定期轮询配额,到阈值时通知。
agy-swap install-agy # 下载并安装 Google Antigravity CLI,并校验其校验和。
agy-swap backup export # 导出账号,再在另一台机器上导入。
agy-swap update # 更新到最新版本,并校验其校验和。
agy-swap completion # 输出 bash、zsh、fish 或 PowerShell 补全脚本。
agy-swap donate [--open] # 显示 GitHub Sponsors 赞助链接,或在浏览器中打开。
专题指南与对照
常见问题
什么是 agy-swap?
agy-swap 是一款用于在一台设备上管理多个 Google Antigravity 账号的开源终端界面与 CLI 工具。它实时跟踪 Gemini、Claude/GPT 与 Gemini 4 Argon 的 5 小时和每周配额及重置时间,并在不打开浏览器的情况下同步切换 agy CLI 与 macOS/Linux 上的 Antigravity IDE。
如何在不退出登录的情况下切换 Google Antigravity 账号?
先用 agy-swap add 保存每个 Google 账号。之后运行 agy-swap 打开终端列表,选中仍有余量的账号,按 Enter 再选择 Switch 即可;也可在脚本中调用 agy-swap switch <email|alias|slot> 或 agy-swap next --family claude 自动轮换。
可以同时用不同账号并行运行多个 Antigravity CLI 会话吗?
可以。若按项目目录自动切换共享会话,可使用 agy-swap profile 和 agy-swap bind 绑定目录并通过 agy-swap run now 启动。若要在 macOS 或 Linux 上让两个 agy CLI 终端同时使用不同 Google 账号,请为第二个终端指定独立的 HOME 目录、放置 antigravity-keyring-unavailable 标记并设置 AGY_SWAP_SKIP_SYNC=1 WSL_INTEROP=1。
agy-swap 监控哪些模型配额池与重置窗口?
它展示 Gemini 与 Claude/GPT 的 5 小时和每周配额池,以及 Pro 套餐单独的每周 Gemini 4 Argon 配额池的剩余百分比与本地重置倒计时,并标注 READY、LOW、GEMINI ONLY、CLAUDE/GPT ONLY、LIMITED 或 VERIFY 状态。
如何在 macOS、Linux 与 Windows 上安装 agy-swap?
macOS 或 Linux 可运行 curl -fsSL --proto '=https' --tlsv1.2 https://agy-swap.aklkbqx.com/install.sh | bash 或 brew install aklkbqx/agy-swap/agy-swap;Windows PowerShell 运行 irm https://agy-swap.aklkbqx.com/install.ps1 | iex;从源码安装运行 go install github.com/aklkbqx/agy-swap/v2/cmd/agy-swap@latest。
agy-swap 把凭证保存在哪里,是否会上传数据?
agy-swap 完全在本地运行,没有任何遥测。已保存的账号令牌存放在仅当前用户可读的 vault.json 文件(权限 0600,未加密)中;设置 AGY_SWAP_VAULT=keychain 可改为存入 macOS Keychain、Windows 凭据管理器或 Linux Secret Service。