macOS · 菜单栏应用 · MIT 开源

菜单栏上的
用量圆环

显示 Codex、Cursor 和 Antigravity 还剩多少额度。用 Swift 写的，安装包不到 7 MB。

github.com/haorui-lab/agentRing Releases ↗

macOS 13+Apple Silicon / Intel中英双语Sparkle 自动更新

Agent Ring 菜单栏弹窗，里面是 Codex、Cursor、Antigravity 的用量圆环
这张截图是 v0.1.8 的菜单栏界面，来自仓库 docs/screenshots。当前发行版是 v0.1.12，界面可能已经不一样。

01 / 用量监控

圆环上能看到什么。

外环是额度，内环是细项。百分比写在明细行里，不叠在圆环中心。

三个平台放在同一个弹窗里

菜单栏弹窗同时显示 Codex、Cursor、Antigravity 的额度和重置时间。可以登录多个账户，切换，也可以给账户起别名。Antigravity 直接用本机已有的凭证，不用再授权一次。

用量在变时刷新得更勤

用量发生变化时，刷新会加快；空闲时会放慢，避免一直请求。

跟随系统外观

用 Swift 写的，安装包不到 7 MB。深浅色和时间格式跟随系统。设置页是系统风格的侧边栏，登录分成几段。额度快用完时会发通知。

02 / 副屏生态

也可以推到旁边的屏幕上。

Mac 端读取用量，再用经典蓝牙 SPP、BLE GATT 或 USB 串口直接发给副屏。数据不经过别的服务器。一块 Mac 可以同时连多块副屏。

源码 ↗

Android 副屏

闲置 Android 手机 / 平板

兼容 Android 5.0 及以上，屏幕可以常亮并全屏显示。通过经典蓝牙 SPP 同步用量、圆环和重置倒计时。

源码 ↗

EPD 墨水屏

4.2" 三色电子纸摆件

400×300 的黑白红三色电子纸。数据变化时才刷新。可以用经典蓝牙 SPP，也可以用 USB 串口。

源码 ↗

ESP32 LCD

微雪 ESP32-P4 7" IPS 触摸屏

1024×600 电容触摸，LVGL 9 渲染，BLE 5.0 GATT 通电即连，也可走 USB-C 串口，无需在系统设置里手动配对。

03 / 下载与构建

下载安装，或者自己编译。

MIT 许可证。这个仓库从 Usage4Claude 的分支继续做，上游作者的工作还在。CI 会在每次提交后构建。

系统要求macOS 13.0+ · Apple Silicon / Intel
技术栈Swift 5 · SwiftUI · Sparkle 2
安装包< 7 MB（DMG）
构建Xcode 15+ · ⌘R 运行
协议MIT License

获取 Agent Ring

发行版 v0.1.12 · 2026-09-20。上面的截图是更早的 v0.1.8 界面。

github.com/haorui-lab/agentRing
  1. 到 Releases 下载 AgentRing-*-macos.dmg（约 7 MB）。
  2. 打开 DMG，把 AgentRing.app 拖入「应用程序」。
  3. 若提示无法验证开发者：系统设置 → 隐私与安全性 → 「仍要打开」。

发布包使用 ad-hoc 签名，未经 Apple 公证。含 Sparkle 的版本支持应用内更新：EdDSA 验签后自动安装重启。