QuotaLens 2.0.1

What's new

• Menu bar shows 5-hour usage. The tray figure now mirrors the selected tool's 5h window (was 7-day); "All" shows the highest 5h across enabled tools.
• Claude cards get full local-usage charts. Each Claude plan card now uses your local ~/.claude/projects activity as its local estimate — real 5h/7d Local meters, a Session bar (tokens + cost), and a token sparkline — alongside the official probe %.
• Percent trend and token sparkline now render independently on each card.
• Global timeline de-duplicates Claude usage across accounts.

Install: download QuotaLens.dmg below, or make install from source.

QuotaLens 1.0.2

What's new

• Bigger statistics window — opens large enough to show the whole dashboard (live quota, totals, breakdown cards, and the trend chart) without scrolling, with a cleaner hero.
• Panel polish — roomier popover cards and a tidier statistics layout.
• Statistics stay in sync with your configured sources — the window now only counts tools you've actually set up (no Claude account → no Claude data), so it never shows numbers you didn't configure.

Install

• Homebrew: brew tap mangiapanejohn-dev/tap && brew install --cask quotalens
• Download: grab QuotaLens.dmg below → open → drag to Applications. It isn't notarized, so on first launch right-click the app → Open, or run xattr -dr com.apple.quarantine /Applications/QuotaLens.app.
• Build: git clone … && cd QuotaLens && make install

Requirements: macOS 13+.

---

简体中文

本次更新

• 统计窗口更大 —— 默认尺寸调大,整个仪表盘(实时额度、总量、分解卡片、趋势图)一屏全展示,无需滚动;hero 也更清爽。
• 面板精修 —— 弹窗卡片更通透,统计布局更整洁。
• 统计与配置严格同步 —— 统计窗口只统计你真正配置过的来源(没配 Claude 账号就不显示 Claude 数据),绝不出现你没设置过的数字。

安装

• Homebrew: brew tap mangiapanejohn-dev/tap && brew install --cask quotalens
• 下载: 取下方 QuotaLens.dmg → 打开 → 拖进 Applications。未公证,首次打开右键 → 打开,或 xattr -dr com.apple.quarantine /Applications/QuotaLens.app。
• 构建: git clone … && cd QuotaLens && make install

环境要求: macOS 13+。

QuotaLens 1.0.1

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+。