QuotaBar for Touch Bar 1.0

A native macOS Touch Bar app for Claude / Codex / Kimi Code usage — a glanceable cell in the Control Strip that follows the AI app you're using, tap to expand a full-width gauge per provider. Shares the same data layer as the desktop widget.

原生 macOS Touch Bar 应用，显示 Claude / Codex / Kimi Code 用量：控制条上常驻一格、跟随你正在用的 AI 应用，点一下展开每家一张仪表卡。与桌面小组件共用同一套数据层。

Install / 安装

1. Download QuotaBar.dmg, open it, drag QuotaBar to Applications.
2. Launch QuotaBar — it pins a cell into the Touch Bar Control Strip; tap it to expand, tap ✕ or the cell again to collapse.
3. To launch at login, run the bundled install.sh from the repo, or add it under System Settings → General → Login Items.

下载 QuotaBar.dmg → 拖 QuotaBar 到「应用程序」→ 打开（控制条常驻一格，点开/收回）。开机自启可用仓库里的 install.sh，或在「系统设置 → 通用 → 登录项」加入。

Requirements & notes / 要求与说明

• A Mac with a Touch Bar, macOS 11+. / 需要带 Touch Bar 的 Mac，macOS 11+。
• Requires python3. Usage is read via /usr/bin/python3; the first launch may prompt to install the Command Line Tools — without it there's no data.
  需要 python3：靠 /usr/bin/python3 取数，首次运行可能提示安装命令行工具，未装则无数据。
• Shows your own usage for whichever of Claude / Codex / Kimi Code you use locally (reads your own CLI login/logs).
  显示你本机实际使用的用量（读你自己的 CLI 登录态/日志）。
• A one-time Keychain prompt may appear to read the Claude login — choose "Always Allow".
  首次可能弹一次 Keychain 授权（读取 Claude 登录态）——点「始终允许」。
• Uses private Touch Bar APIs through the Objective-C runtime; signed with Developer ID and notarized by Apple — no Gatekeeper warning.
  通过 ObjC runtime 调用私有 Touch Bar 接口；Developer ID 签名 + Apple 公证，无 Gatekeeper 拦截。

QuotaWidget for macOS 1.0

A native macOS WidgetKit widget for Claude / Codex / Kimi Code usage, on your desktop and in Notification Center. A menu-bar companion app refreshes the data.

原生 macOS 小组件，显示 Claude / Codex / Kimi Code 用量（桌面 + 通知中心），由菜单栏伴侣 app 刷新数据。

Install / 安装

1. Download QuotaWidget.dmg, open it, drag QuotaWidget to Applications.
2. Launch QuotaWidget — it runs in the menu bar (gauge icon).
3. Add the AI Agent Usage widget from the widget gallery (desktop or Notification Center).

下载 QuotaWidget.dmg → 拖 QuotaWidget 到「应用程序」→ 打开（在菜单栏，仪表图标）→ 从小组件库添加 AI Agent Usage。

Requirements & notes / 要求与说明

• macOS 14 (Sonoma)+ · Universal (Apple Silicon + Intel) / 通用二进制。
• Requires python3. Usage is read via /usr/bin/python3; on recent macOS the first launch may prompt to install the Command Line Tools — without it the widget shows no data.
  需要 python3：靠 /usr/bin/python3 取数，新版 macOS 首次运行可能提示安装命令行工具，未装则无数据。
• Shows your own usage for whichever of Claude / Codex / Kimi Code you use locally (reads your own CLI login/logs).
  显示你本机实际使用的 Claude / Codex / Kimi Code 用量（读你自己的 CLI 登录态/日志）。
• Keep the menu-bar app running; add it under System Settings → General → Login Items to launch at login.
  保持菜单栏 app 运行；在「系统设置 → 通用 → 登录项」加入可开机自启。
• Signed with Developer ID and notarized by Apple — no Gatekeeper warning.
  Developer ID 签名 + Apple 公证，无 Gatekeeper 拦截。