Overview
全貌——貢獻圖、agent 額度與進度、即時 session、模型佔比、連續紀錄。
Local-first · 原生 macOS 選單列
TokenBar 在你的 Mac 上直接讀取 AI 編碼工具的本機紀錄,攤開 25+ 個 agent 的花費——Claude Code、Codex、Cursor、OpenCode 等等。原生 Swift、披上 Liquid Glass。零遙測、免帳號,只給你數字。
25+ agents · 7 種視圖 · 160 fps 3D · 0 遙測
Native Swift · Liquid Glass
這就是現在的 TokenBar——自 v1.0.0 起,整個 app 都是從零重寫的原生程式。同一套儀表板、同樣的數字,多了系統原生的玻璃、彈簧動畫與速度。
SwiftUI + AppKit 包著 Rust 核心——沒有 webview。popover 一點即開,感覺像系統的一部分,因為它就是。
在 macOS 26 上,儀表板是漂在桌布上的 Liquid Glass 玻璃卡——系統原生的真材質,不是 CSS 仿的。較舊的系統自動退回 vibrancy。
年度貢獻地形是貨真價實的 3D 場景,可旋轉、可縮放——鏡頭位置每次開啟都記得。
App 內更新走簽章驗證的 Sparkle feed,更新說明由實際 commit 摘要而成。Beta 通道在設定裡一鍵切換。
oiiai 旋轉貓來自 tokcat,party parrot 來自 RunCat。滑過去餵牠們一點 token。
選單列就是儀表板
Status item 可以顯示訂閱額度視窗還剩多少——訊號格、圓環,或一支隨五小時視窗流逝慢慢融化的冰棒。電池式警示色在要緊時亮起:剩 25% 以下轉琥珀、10% 以下轉紅。右鍵選擇要追蹤哪個訂閱。
16px 網格即時繪製 · 與 app 同一套幾何
骨子裡 local-first
TokenBar 的設計,讓「我的資料去了哪?」可以誠實回答:哪都沒去。
用量來自磁碟上既有的 session 紀錄。不上傳、不挖掘——解析由 vendored tokscale-core 在本機完成。
沒有分析、不用註冊、沒有雲端同步。TokenBar 不會回報你做了什麼、花了多少。
網路存取僅限:簽章的更新 feed、公開的模型價格資料,以及——僅當本機已有 Codex/Claude OAuth 憑證時——直連官方的額度查詢(供額度卡使用)。永遠沒有第三方。
兩分鐘,Apple Silicon
TokenBar 透過 Homebrew 安裝,需要 Apple Silicon Mac 與 macOS 14+。cask 全名會自動 tap,不用另外 brew tap。
正式出貨版。App 內更新走簽章驗證的 Sparkle feed,安裝前都會驗證;beta 版只是設定裡的開關,不是另一個 cask。
$ brew install --cask nanako0129/tokenbar/tokenbar 還在用舊一點的 Mac?tokenbar@legacy 釘住最後一版 Tauri build(v0.4.5,macOS 11+)——legacy repo 已封存,但 cask 會留著。想自己編譯?Swift 6 + Rust,Command Line Tools 就夠。
常見問題
安裝前大家最想知道的幾個簡答。
免費開源的原生 macOS 選單列 app,讀取本機的 AI 編碼 session 紀錄,把你的花費攤開來看——貢獻圖、各模型與各 agent 細目、每月、每日與每時視圖、即時吞吐量。不用跑 CLI、免帳號。
25+ 個 agent,直接讀本機紀錄——Claude Code、Codex CLI、Cursor、OpenCode、Gemini CLI、Copilot CLI、Amp、Droid、Hermes、Goose、Kilo/KiloCode、Roo Code、Qwen、Kimi、Crush、Zed、Kiro、Trae、Warp 等。解析交給 vendored tokscale-core,涵蓋範圍跟著 tokscale 走。
不用。TokenBar 採 MIT 授權、完全免費——沒有訂閱、沒有付費版、沒有遙測。
TokenBar 最初是 tokcat 的 Tauri fork。v1.0.0(2026 年 6 月)起換成從零重寫的原生 Swift app,沿用同一顆 Rust 解析核心——`tokenbar` cask 現在裝的就是原生版,Tauri repo 已封存。`tokenbar@legacy` cask 釘住最後一版 Tauri build(v0.4.5),支援 macOS 11+。
App 內更新,走簽章的 Sparkle feed——每個版本安裝前都會驗證簽章,更新說明由實際 commit 摘要而成。想吃 beta?設定裡一個開關,不用另外安裝。
哪都沒去。用量歷史直接從磁碟讀。網路請求僅限:簽章更新 feed、公開模型價格資料,以及使用你機器上既有 OAuth 憑證的選擇性 Codex/Claude 額度查詢——選單列額度儀錶和 agent 額度卡就是靠這個。
TokenBar 鎖定 Apple Silicon(arm64)、macOS 14+;Liquid Glass 需要 macOS 26,較舊系統退回 vibrancy。Legacy Tauri 版涵蓋 macOS 11+。沒有 Intel、Windows 或 Linux 版。
brew uninstall --cask tokenbar。
站在肩膀上
沒有這些專案就沒有 TokenBar——感謝每一位維護者。
整個專案的地基。vendored 的 tokscale-core crate 驅動 TokenBar 跨 25+ agent 的 session 解析、去重與計價——而它的互動式 TUI 更是整套儀表板的藍本:七種透鏡,連同 In · Out · CR · CW 的欄位拆解,都照著它來。
到 GitHub 看 ↗TokenBar 產品線的起點——原版的 Tauri 選單列監視器(它自己也建立在 tokscale 之上)。原生版是從零的 Swift 重寫、不含任何 tokcat 程式碼,但選單列寵物的形態與 oiiai 旋轉貓的招牌創意都來自這裡。
到 GitHub 看 ↗選單列養寵物(動得多快反映你多忙)這個設計的始祖。party parrot、以及每一隻在 Mac 選單列上衝刺過的貓(tokcat 的和 TokenBar 的都算),都可以追溯到這裡。
到 GitHub 看 ↗TokenBar 的額度進度呈現——超前或落後視窗、預計耗盡時間——參考了 CodexBar 的做法。
到 GitHub 看 ↗