Local-first · macOS menu bar

Know every AI
token you burn.

TokenBar reads your AI coding logs on-device and lays your spend bare across 25+ agents — Claude Code, Codex, Cursor, OpenCode and more. No telemetry. No account. Just the numbers.

View on GitHub

25+: agents tracked
6: dashboard views
2D · 3D: contribution graph
0: telemetry, accounts

A gauge, not a mascot

The cat spins faster
the more you burn.

Your token throughput as a single glanceable critter: idle when nothing's flowing, whirling when Claude Code is mid-refactor. One look at the menu bar tells you how fast the meter is running — no window required.

The spinning cat is the signature creative touch of the original tokcat by handlecusion — kept here with gratitude.

One popover, six lenses

App tabs filter who. The view switch picks how.

Pick which agents you’re looking at, then choose how to break them down — a multi-view dashboard inspired by tokscale’s TUI.

Overview

The whole picture — contribution chart, agent limits, live session, model breakdown, streaks.

Models

Every model ranked by cost, with its share and a dim In · Out · CR · CW split.

Daily

Active days newest-first — select one to drill into that day’s per-model spend.

Hourly

A 24-hour-of-day rhythm: when in the day your tokens actually get spent.

Stats

Headline summary — total spend, active days, streaks, favorite model, best day.

Agents

Sub-agents ranked by cost, with their source apps, message count, and tokens.

3D contribution graph

The same year of usage as an interactive GitHub-style tile terrain — orbit it, and the stacked 2D bars are one toggle away. Tokens stack by model (provider shades) or by agent (brand colors).

Local-first by construction

Your spend stays on your Mac.

TokenBar is built so the honest answer to “where does my data go?” is: nowhere.

Reads on-device

Usage comes from the session logs already on your disk. Nothing is uploaded, nothing is mined — the parse happens locally via the vendored tokscale-core.

No telemetry, no account

No analytics, no sign-up, no cloud sync. TokenBar never phones home with what you do or what you spend.

Two requests, that’s it

Network access is limited to the GitHub Releases updater manifest and public model-pricing data. Updates are signature-verified before install.

Two minutes, Apple Silicon

Install, click the cat, done.

TokenBar installs through Homebrew for macOS 11+ on Apple Silicon. The fully-qualified cask auto-taps, so there is no separate brew tap step.

The in-app updater checks GitHub Releases on launch and every 30 min.
Signed artifacts are verified against the embedded public key before install.
Building from source is available for development and local testing.

$ brew install --cask nanako0129/tokenbar/tokenbar

Building from source? Rust + Node ≥ 22.

Questions

Good to know.

The short answers most people want before installing.

What exactly is TokenBar?

A free, open-source macOS menu-bar app that reads your local AI coding session logs and shows what you’re spending — across a contribution graph, per-model and per-agent breakdowns, daily and hourly views, and live throughput. No CLI to run, no account.

Which AI coding tools does it track?

25+ agents from their local logs — 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 and more. Parsing is handled by the vendored tokscale-core, so coverage tracks tokscale.

Does it cost anything?

No. TokenBar is MIT-licensed and free — no subscription, no paid tier, no telemetry.

Where does my data go?

Nowhere. Usage history is read locally from disk. The only network requests are the GitHub Releases updater manifest and public model-pricing data.

Intel Mac or Windows?

TokenBar targets Apple Silicon (arm64), macOS 11 and later. There’s no Intel, Windows, or Linux build.

How do I uninstall it?

brew uninstall --cask tokenbar.

Standing on shoulders

Built on great open source.

TokenBar wouldn’t exist without these projects — thank you to their maintainers.

tokcat

by handlecusion

The original macOS menu-bar token monitor TokenBar is forked from. The Tauri shell, native tray, and the spinning menu-bar cat all originate here.

View on GitHub ↗

tokscale

by Junho Yeo

Its tokscale-core crate powers TokenBar’s multi-agent session parsing, dedup, and pricing. The multi-view dashboard is inspired by tokscale’s TUI.