Tokcat

Local command center for AI spend

Tokcat

AI token usage monitor and LLM cost tracker for Claude Code usage, Codex usage, Cursor usage, Copilot, Gemini, OpenCode, Amp, Droid, and Hermes. Local logs in, clear spend out.

Install with Homebrew Latest release
Runtime
macOS 11+ arm64/x64
Data path
Local-only logs
Surface
2D and 3D graph
No telemetry Signed updater Local only

Quick start

Install, launch, click the menu-bar cat.

Tokcat reads supported AI coding session logs directly on your Mac. No separate token-usage CLI, cloud account, or telemetry pipeline is required. 

brew install --cask handlecusion/tokcat/tokcat

Operational surfaces

See the menubar workflow before you install.

Real Tokcat screenshots show the daily cost view, the 2D stacked chart, 3D contribution graph, and the settings panel used to tune the menubar behavior.

Tokcat 3D contribution graph dashboard

3D contribution graph

Interactive tile terrain with cost and token totals visible at a glance.

Tokcat 2D stacked token dashboard

2D stacked chart

Recent token usage stacked by AI coding client.

Tokcat settings panel

System-style settings

Menu-bar title, launch at login, animation style, and updater checks.

Supported sources

One local dashboard for the AI tools that leave usage trails.

Each source is normalized into the same contribution timeline, so token-heavy days and high-cost clients stand out without leaving the menu bar.

  • Claude Code
  • OpenAI Codex
  • Cursor
  • GitHub Copilot
  • Gemini
  • OpenCode
  • Amp
  • Droid
  • Hermes

Why it exists

Token spend is easier to manage when it is always visible.

Glanceable

The animated menu-bar title can show today's tokens, today's cost, total tokens, total cost, or icon-only mode.

Native

Tauri 2, Rust, React, macOS vibrancy, light and dark adaptation, and a chromeless popover window.

Multi-client

Overview and client tabs for Claude Code, Codex CLI, Cursor IDE, Copilot CLI, Gemini CLI, OpenCode, Amp, Droid, and Hermes.

Actionable

Streaks, daily average, best day, per-client totals, and model-aware cost estimates make usage patterns obvious.

Privacy model

No telemetry. No account. No cloud sync.

Tokcat's only network traffic is the signed updater manifest from GitHub Releases. Usage data is read from local session logs and rendered in the menubar dashboard on-device.

FAQ

Common install and usage questions.

What is Tokcat?

Tokcat is a free, open-source native macOS menu-bar app that visualizes AI coding token usage as 2D stacked token bars and a 3D contribution graph.

How much does Tokcat cost?

Tokcat is free and open-source under the MIT license. There is no subscription, paid tier, telemetry, or account.

Which AI coding tools does Tokcat track?

Tokcat tracks Claude Code, OpenAI Codex CLI, Cursor IDE, OpenCode, Google Gemini CLI, GitHub Copilot CLI, Amp, Droid, and Hermes from local logs.

Does Tokcat send my data anywhere?

Token usage history stays local. The app checks GitHub Releases for updater metadata, can call direct Codex/Claude quota endpoints, and does not run analytics.

Does Tokcat run on Intel Macs or Windows?

Tokcat ships for Apple Silicon and Intel Macs on macOS 11 or newer. Windows support lives in the separate handlecusion/tokcat-window port repo; Linux is not supported.