+ 
+
+
+ 3D contribution graph
+Interactive tile terrain with cost and token totals visible at a glance.
+
+
+ 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. +
+ +-
+
- 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 is an AI token usage monitor and LLM cost tracker for the macOS menu bar, - built with Tauri 2 (Rust + React/Vite). It tracks Claude Code usage, OpenAI Codex usage, Cursor usage, - OpenCode, Google Gemini, GitHub Copilot, Amp, Droid, and Hermes as a 2D or 3D GitHub-style - contribution graph. The animated cat icon shows today's tokens or USD cost; clicking opens a - frosted-glass popover with per-client filters, streak summaries, and a settings panel. Tokcat - reads local usage logs on-device, checks for signed updates every 30 minutes, ships zero - telemetry, and requires no account. -
+
+
+
+
+
+ 
+
+
+ 
+
+
+
+
+
+
+ 2D heatmap
+GitHub-style daily activity for long-term AI coding agent usage.
+
+
+
+ System-style settings
+Menu-bar title, launch at login, animation style, and updater checks.
+Install
-brew tap handlecusion/tokcat
-brew install --cask tokcatOr grab the latest signed DMG from - GitHub Releases.
+
+
+
+
+ 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 +
Links
--
-
- Source on GitHub -
- README (English) -
- README (한국어) -
- Homebrew tap -
- llms.txt -
+
+
+
+ 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.
+FAQ
-What is Tokcat?
-Tokcat is a free, open-source native macOS menu-bar app that visualizes your AI coding token usage as a 2D or 3D GitHub-style contribution graph. Its Tauri 2 backend reads local sessions from Claude Code, Codex, Cursor, OpenCode, Gemini, Copilot, Amp, Droid, and Hermes in one glanceable place. The app runs entirely on-device, makes zero analytics requests, and requires no account.
-How much does Tokcat cost?
-Tokcat is free and open-source under the MIT licence. There is no subscription, no paid tier, and no telemetry. Install with brew tap handlecusion/tokcat && brew install --cask tokcat.
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. New client formats are added in Tokcat's Rust usage reader.
-Does Tokcat send my data anywhere?
-No. Tokcat's only network request is a check against the GitHub Releases updater manifest. There is no telemetry, no analytics, no cloud sync, no account, and no third-party server. All token data is read locally from session logs.
-How is Tokcat different from CLI token-usage tools?
-Tokcat is a native macOS GUI and background local-log reader — an animated menu-bar cat, a click-to-open frosted-glass dashboard with a 2D heatmap and an interactive 3D tile graph, per-client filters, streaks, and a settings panel. It does not require a separate token-usage CLI at runtime.
-Does Tokcat run on Intel Macs or Windows?
-Tokcat ships only for Apple Silicon (arm64) on macOS 11+. There is no Intel x86_64 build and no Windows or Linux build.
-
+
+
+
+ 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. +
+Privacy
-
- No telemetry. No cloud sync. No account. Tokcat's only network traffic is the updater
- manifest fetched from github.com/handlecusion/tokcat/releases/latest/download/latest.json
- every 30 minutes. All token-usage data is read locally from session logs.
-
+
+
+
+ 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.
+