Local-first · 原生 macOS 選單列

每顆 AI token
怎麼的,都知道。

TokenBar 在你的 Mac 上直接讀取 AI 編碼工具的本機紀錄,攤開 25+ 個 agent 的花費——Claude Code、Codex、Cursor、OpenCode 等等。原生 Swift、披上 Liquid Glass。零遙測、免帳號,只給你數字。

在 GitHub 上看

25+ agents · 7 種視圖 · 160 fps 3D · 0 遙測

TokenBar popover:token 用量儀表板,含 agent 額度與即時進度

Native Swift · Liquid Glass

用 Swift 重寫。
披上 Liquid Glass。

就是現在的 TokenBar——自 v1.0.0 起,整個 app 都是從零重寫的原生程式。同一套儀表板、同樣的數字,多了系統原生的玻璃、彈簧動畫與速度。

原生 TokenBar popover 以 Liquid Glass 浮在桌布上
  • 100% 原生 Swift 外殼

    SwiftUI + AppKit 包著 Rust 核心——沒有 webview。popover 一點即開,感覺像系統的一部分,因為它就是。

  • 真正的 Liquid Glass

    在 macOS 26 上,儀表板是漂在桌布上的 Liquid Glass 玻璃卡——系統原生的真材質,不是 CSS 仿的。較舊的系統自動退回 vibrancy。

  • SceneKit 3D,160 fps

    年度貢獻地形是貨真價實的 3D 場景,可旋轉、可縮放——鏡頭位置每次開啟都記得。

  • Sparkle 更新+AI 寫的更新說明

    App 內更新走簽章驗證的 Sparkle feed,更新說明由實際 commit 摘要而成。Beta 通道在設定裡一鍵切換。

oiiai 旋轉貓來自 tokcat,party parrot 來自 RunCat。滑過去餵牠們一點 token。

儀錶,不是吉祥物

燒得越快,
貓轉得越快。

你的 token 吞吐量濃縮成選單列上一隻一眼可讀的小生物:沒事時發呆,Claude Code 重構到一半時狂轉。瞄一眼選單列就知道錶轉多快——不用開任何視窗。

選單列養寵物(動得多快反映你操得多兇)這個設計,源自 Takuto NakamuraRunCat,party parrot 也是從這裡來的。tokcathandlecusion)把它帶進 token 用量監視,並以 oiiai 旋轉貓當招牌。TokenBar 最初是 tokcat 的 fork,oiiai 貓與 party parrot 都心懷感激地沿用。

選單列就是儀表板

你的額度,
即時融化中。

Status item 可以顯示訂閱額度視窗還剩多少——訊號格、圓環,或一支隨五小時視窗流逝慢慢融化的冰棒。電池式警示色在要緊時亮起:剩 25% 以下轉琥珀、10% 以下轉紅。右鍵選擇要追蹤哪個訂閱。

16px 網格即時繪製 · 與 app 同一套幾何

訊號格
融化冰棒
圓環

一個 popover,七種透鏡

App 分頁選「看誰」,視圖切換選「怎麼看」。

先挑要看的 agent,再選拆解方式——多視圖儀表板的版面,連透鏡與欄位都照著 tokscale 的 TUI 來設計。

TokenBar Overview 視圖

Overview

全貌——貢獻圖、agent 額度與進度、即時 session、模型佔比、連續紀錄。

TokenBar Models 視圖

Models

每個模型按花費排名,附佔比與 In · Out · CR · CW 細目。

TokenBar Monthly 視圖

Monthly

活躍月份由新到舊排列——點選一個月即可下鑽該月各模型的花費。

TokenBar Daily 視圖

Daily

活躍日由新到舊排列——點選一天即可下鑽當日各模型的花費。

TokenBar Hourly 視圖

Hourly

24 小時節奏圖:你的 token 實際都燒在一天的哪些時段。

TokenBar Stats 視圖

Stats

重點摘要——總花費、活躍天數、連續紀錄、最愛模型、最高一日。

TokenBar Agents 視圖

Agents

子 agent 按花費排名,附來源 app、訊息數與 token 量。

TokenBar 可互動的 3D 貢獻圖

3D 貢獻圖

同一年的用量化成可互動的 GitHub 式方塊地形——旋轉它,2D 堆疊長條一鍵切換。Token 可按模型(供應商色階)或按 agent(品牌色)堆疊,單位可選 token 或美元。

骨子裡 local-first

你的花費,留在你的 Mac 上。

TokenBar 的設計,讓「我的資料去了哪?」可以誠實回答:哪都沒去。

01

本機讀取

用量來自磁碟上既有的 session 紀錄。不上傳、不挖掘——解析由 vendored tokscale-core 在本機完成。

02

零遙測、免帳號

沒有分析、不用註冊、沒有雲端同步。TokenBar 不會回報你做了什麼、花了多少。

03

每個請求,攤開講

網路存取僅限:簽章的更新 feed、公開的模型價格資料,以及——僅當本機已有 Codex/Claude OAuth 憑證時——直連官方的額度查詢(供額度卡使用)。永遠沒有第三方。

兩分鐘,Apple Silicon

一行指令,貓就搬進來。

TokenBar 透過 Homebrew 安裝,需要 Apple Silicon Mac 與 macOS 14+。cask 全名會自動 tap,不用另外 brew tap

TokenBar

Native Swift · macOS 14+

正式出貨版。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 就夠。

常見問題

先說清楚。

安裝前大家最想知道的幾個簡答。

TokenBar 到底是什麼?

免費開源的原生 macOS 選單列 app,讀取本機的 AI 編碼 session 紀錄,把你的花費攤開來看——貢獻圖、各模型與各 agent 細目、每月、每日與每時視圖、即時吞吐量。不用跑 CLI、免帳號。

追蹤哪些 AI 編碼工具?

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 授權、完全免費——沒有訂閱、沒有付費版、沒有遙測。

原本的(Tauri)版本怎麼了?

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 額度卡就是靠這個。

Intel Mac 或 Windows 呢?

TokenBar 鎖定 Apple Silicon(arm64)、macOS 14+;Liquid Glass 需要 macOS 26,較舊系統退回 vibrancy。Legacy Tauri 版涵蓋 macOS 11+。沒有 Intel、Windows 或 Linux 版。

怎麼移除?

brew uninstall --cask tokenbar。

站在肩膀上

建立在出色的開源之上。

沒有這些專案就沒有 TokenBar——感謝每一位維護者。