Skip to content

QuotaLens 1.0.1

Choose a tag to compare

View all tags
@mangiapanejohn-dev mangiapanejohn-dev released this 25 Jun 08:56
v1.0.1
9d35330

QuotaLens is a macOS menu-bar gauge for your Claude and Codex usage — an always-visible ring + percentage, a detail panel with a card per source, and a full statistics window.

Highlights

  • Multiple Claude accounts — add each with its own claude setup-token; one card per account (up to 4 sources total).
  • Authoritative limits — Claude reads the real anthropic-ratelimit-unified-* headers; Codex reads its official rate_limits locally, with no network.
  • Token-expiry alerts — an expired token is flagged on its card and sent as a notification, so you know to re-paste.
  • Statistics window — tokens / cost / cache with a smooth multi-series trend chart (Today / 3d / 7d / 30d / All / custom; short ranges render hourly, hover for detail). It stays in sync with the sources you've configured.
  • Launch at login, a custom app icon, and a drag-to-install DMG.

Install

Option A — download. Grab QuotaLens.dmg below, open it, drag QuotaLens to Applications. The build is ad-hoc signed (not notarized), so the first launch needs one of:

  • Right-click the app → Open → Open, or
  • xattr -dr com.apple.quarantine /Applications/QuotaLens.app

Option B — build it yourself (recommended; skips Gatekeeper entirely):

git clone https://github.com/mangiapanejohn-dev/QuotaLens.git
cd QuotaLens && make install

Getting started

Run claude setup-token, then in QuotaLens → gear → Sources → Add Claude account, give it a name and paste the token. Codex needs no setup — it reads ~/.codex/sessions automatically.

Everything runs locally; the only network call is a tiny, throttled Claude probe used solely to read the rate-limit headers. Full details in the README.

Requirements: macOS 13+.

简体中文

QuotaLens 是 macOS 菜单栏里的 Claude / Codex 用量表盘 —— 常驻的圆环 + 百分比,点开是每个来源一张卡的面板,另有完整的统计窗口。

亮点

  • 多 Claude 账号 —— 每个粘自己的 claude setup-token,各成一张卡(整个面板最多 4 个来源)。
  • 权威额度 —— Claude 读真实的 anthropic-ratelimit-unified-* 响应头;Codex 本地读官方 rate_limits,不联网。
  • token 过期提醒 —— 过期的 token 在卡片上标红并发系统通知,提醒重新粘贴。
  • 统计窗口 —— token / 成本 / 缓存 + 丝滑多序列趋势图(今天 / 3天 / 7天 / 30天 / 全部 / 自定义,短范围按小时,hover 看明细),严格跟你配置的来源同步。
  • 开机自启、自定义图标、拖拽式安装 DMG。

安装

  • 下载: 取下方 QuotaLens.dmg,打开后把 QuotaLens 拖进 Applications。因为是 ad-hoc 签名(未公证),首次打开需 右键 → 打开 → 打开,或执行 xattr -dr com.apple.quarantine /Applications/QuotaLens.app。
  • 自行构建(推荐,绕过 Gatekeeper): git clone … && cd QuotaLens && make install。

上手: 运行 claude setup-token,在 QuotaLens → 齿轮 → Sources → Add Claude account 里命名并粘贴 token;Codex 无需配置。一切本地运行,唯一联网是一个极小、限频的 Claude 探测。环境要求: macOS 13+。

Assets 3
Loading