这个项目能做什么

agys(Antigravity Switcher)是一个纯 Go 编写的命令行工具,用于在 Google Antigravity 生态系统中隔离和编排多个账户配置文件,包括 Antigravity CLI(agy)、Antigravity IDE、Antigravity 2.0 桌面应用(GUI)以及 Antigravity 远程控制。它还提供与 Herdr 多智能体工作区的原生集成。 每个配置文件严格沙箱化在 `~/.agys/profiles/<profile_name>/` 下,通过动态 `$HOME` 路由防止认证令牌泄漏,实现独立配置和隔离的配额跟踪。这使得用户可以在不同 Google 账户下同时运行多个面板或 IDE 窗口,而不会发生会话冲突。 主要功能包括: - 实时 5 小时和每周配额 HUD 跟踪,覆盖所有已配置账户,并带有重置倒计时器。 - 基于最佳 5 小时 Gemini 配额的智能自动配置文件选择,支持自定义优先级权重。 - 系统健康诊断(`agys doctor`),审计二进制文件、OAuth 令牌、Keychain 隔离、模型发现和 Herdr 套接字 RPC。 - 多配置文件 MCP 管理,用于检查和同步 Model Context Protocol 服务器。 - 会话历史搜索和恢复,支持交互式提示搜索和工作区分组。 - 并行 Antigravity IDE 启动,使用隔离的 `--user-data-dir` 存储。 - 桌面应用 GUI 切换,支持 macOS Keychain OAuth 同步。 - 远程 SSH 执行,具有即时凭据同步和反向隧道 API 调用,以绕过数据中心地理封锁。 - 无头远程控制守护进程管理,支持动态端口分配。 - 使用最佳配额配置文件进行 AI 驱动的分阶段 git 提交生成。 - 配置文件克隆、导出/导入、重命名和删除工具。 - 支持 zsh、bash、fish 和 powershell 的 shell 补全,以及别名生成。 - 原地原子自升级。 对于 Herdr 用户,agys 提供 3 行高对比度侧边栏遥测,显示活动配置文件、上下文窗口使用量、模型 ID 以及双 5 小时/每周配额。它采用混合遥测方法:通过 Antigravity `statusLine` 钩子流进行逐轮推送,实现即时上下文更新,以及被动 60 秒轮询监视器,用于重置倒计时和配额恢复。 安装可通过一行 shell 安装程序或从源码(需要 Go 1.22+)进行。该工具支持 macOS 和 Linux 跨平台,且零 CGO 依赖。