TokenBar

AI token usage & quota monitor for the macOS menu bar — native Swift, Liquid Glass.

TokenBar sits in your menu bar and shows what you're spending across 25+ AI coding agents — Claude Code, Codex, Cursor, OpenCode, Gemini CLI and more — read on-device from your local session logs. No Dock icon, no telemetry, no account.

The menu-bar title shows today's tokens, cost, live tokens/min, or how much subscription quota is left — as signal bars, a ring, or a popsicle that melts as your window drains. And the cat sprints faster the more you burn, tracing back to RunCat by Takuto Nakamura.

---

The dashboard

Click the icon and a Liquid Glass popover opens. A row of app tabs filters which agents you're looking at; a view switch picks how that data is broken down — six lenses, plus the same year of usage as an orbitable 3D graph.

Models — every model ranked by cost	Daily — active days, with day drill-down
Hourly — when in the day you burn tokens	Stats — headline summary & streaks
Agents — sub-agents ranked by cost	Settings — menu-bar title, icon & quota source

Plus OAuth quota cards with pace projections, a live session trace, streaks, and full keyboard control (⌘1–9 tabs, ⌘G chart toggle, ⌘, settings). A failed refresh never blanks a reading — the last known value stays until a fresh one lands.

Install

brew install --cask nanako0129/tokenbar/tokenbar

In-app updates arrive via Sparkle; betas ride an opt-in channel (Settings → "Receive beta updates"). The app is ad-hoc signed (not notarized) — the cask clears the quarantine attribute on install, as disclosed. Requires an Apple Silicon Mac on macOS 14+ (Liquid Glass needs macOS 26; earlier systems get a vibrancy fallback). Still on macOS 11–13? The final Tauri build stays as tokenbar@legacy.

How it works

Rust owns the data — session parsing, aggregation, pricing, quota fetching — via the vendored tokscale-core, exposed to Swift as a C-ABI staticlib (crates/tb_core_ffi). Swift owns the rest: SwiftUI views, the NSStatusItem shell, Sparkle updates.

make        # cargo build --release, then swift build
make run    # build + run the smoke binary

Run swift build from the repo root — the linker's -L target/release path in Package.swift is relative.

Credits

TokenBar began as a fork of tokcat by handlecusion (the spinning-cat idea is theirs, tracing to RunCat by Takuto Nakamura). Parsing and pricing come from tokscale by Junho Yeo. The menu-bar shell patterns reference CodexBar by Peter Steinberger. All MIT.

Licensed under MIT.