返回作品星图

OPEN SOURCE · MACOS UTILITY

Codex
Quota Ring把剩余额度留在视线里

一款使用 Swift 与 AppKit 构建的原生 macOS 菜单栏工具。 它通过 Codex 本地 app-server 读取限额窗口,把最低剩余比例放进一枚 C 形圆环,让你不用离开当前工作就能看见余量。

Swift 5.9+macOS 13+Codex CLI

只显示重要的,
其余保持安静。

圆环始终保持固定的 C 形开口,黄色标记会随最低剩余百分比移动。 剩余超过 50% 时为绿色,21–50% 为橙色,20% 或更低为红色; 无可用数据或连续读取失败时,中央数字会变为感叹号。

SIGNAL · 01

显示最紧张的额度

读取主额度、次额度与可用的消费额度窗口,将其中最低的剩余百分比显示在菜单栏圆环中央。

SIGNAL · 02

原生菜单展开明细

点击圆环打开 macOS 原生菜单,查看每个窗口的剩余比例、重置时间、最后更新时间,并可立即刷新。

SIGNAL · 03

事件与定时双重刷新

每 60 秒读取一次数据,也响应 Codex 的额度更新事件。读取失败后等待 5 秒重试,避免短暂波动打断显示。

SIGNAL · 04

三次失败才切换错误

已经成功读取过额度时,短暂失败仍保留最近一次圆环数值;连续失败三次后,圆环才显示红色感叹号。

LOCAL FIRST

额度数据留在本机。

工具启动本机 Codex CLI 的 `app-server --stdio`, 通过 `account/rateLimits/read` 读取限额数据。 它不读取、复制或记录认证令牌,也不会把额度信息发送到其他服务。

本地读取 Codex 限额不复制或记录认证令牌通过本机 stdio 与 Codex 通信

BUILD & RUN

从源码运行

需要 macOS 13+、Swift 5.9+,并已安装且登录 Codex CLI。 安装脚本会创建 `~/Applications/Codex Quota Ring.app`, 并注册用户级 LaunchAgent,使它在登录后自动启动。

git clone https://github.com/sv-yan-public/codex-quota-ring.git cd codex-quota-ring chmod +x scripts/install.sh scripts/uninstall.sh ./scripts/install.sh

仓库同时提供可构建的 `.pkg` 安装包;当前包使用本地临时签名, 未进行 Developer ID 签名或 Apple 公证。