TeaLance/AgentMeter

AgentMeter

在 macOS 選單列即時看到 Claude Code 與 OpenAI Codex 的用量——context window 使用率、訂閱額度（5 小時／每週）、今日 token 與訊息數。用量統計讀本機檔案、不需要 API key；「即時額度／登入帳號」為選用的連網功能，可一鍵關成完全離線。

 ✳ 5h 62% · 7d 16%   ❖ 5h 1%      ← 選單列：每個服務前有 agent 標誌 + 你選的指標
 ┌──────────────────────────────┐
 │ Claude Code                ●  │
 │   Context window  289k/1.0M 29%│
 │   ▕███▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▏        │
 │   5-hour limit         39% · 2h│
 │   Weekly              14% · 4d │
 │   今日 2.4M   訊息 542          │
 │ Codex                      ●  │
 │   5-hour limit          1% · 5h│
 └──────────────────────────────┘

安裝

brew install --cask TeaLance/tap/agentmeter

或不用終端機：到 Releases 頁 下載 AgentMeter-x.y.z.zip → 解壓縮 → 把 AgentMeter.app 拖進「應用程式」。已經過 Apple 公證，雙擊直接開、不跳警告。

需求：macOS 14 (Sonoma) 以上。

功能

• 選單列可自選多個指標並排顯示，每個服務前有 agent 標誌（可關），並可選直向／橫向排列
• Claude Code 與 Codex 的今日 token、訊息數、context window 使用率
• 真實的 5 小時／每週訂閱額度 % 與 reset 時間（到「設定 → 一般 → 即時額度與連線」啟用即可）
• 可調更新頻率、開機自動啟動

隱私

用量統計只讀取本機 ~/.claude 與 ~/.codex 的紀錄,不讀 Keychain、不傳送任何資料給第三方。

為了顯示登入帳號與真實額度,預設會做兩件事(都可在設定 → 一般 → 即時額度與連線關閉):

• 顯示登入帳號：讀取本機登入憑證「檔案」(不讀 Keychain)解出 email/方案;不連網。
• Codex 即時額度：用本機憑證的權杖連線 OpenAI 取得真實 5h／每週額度。

關閉以上兩項後即完全離線。網路碼僅限於 Sources/AgentMeter/Network/(有 CI Scripts/check-offline.sh 把關)。

授權

MIT © TeaLance