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
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 and 3D contribution graphs, 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 heatmap dashboard

2D heatmap

GitHub-style daily activity for long-term AI coding agent usage.

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

Filter by Claude Code, Codex, Cursor, Copilot, Gemini, OpenCode, Amp, Droid, Hermes, and compatible logs.

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 a 2D or 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, Cursor, OpenCode, Google Gemini, GitHub Copilot, Amp, Droid, Hermes, and compatible local logs.

Does Tokcat send my data anywhere?

No. Token usage stays local. The app checks GitHub Releases for updater metadata and does not run analytics.

Does Tokcat run on Intel Macs or Windows?

Tokcat ships for Apple Silicon Macs on macOS 11 or newer. There is no Intel, Windows, or Linux build.