# Tokcat

> Tokcat is an AI token usage monitor for the macOS menu bar: a Claude Code usage tracker, Codex usage tracker, Cursor usage dashboard, and LLM cost tracker for AI coding agent usage across Claude Code, Codex, Cursor, OpenCode, Gemini, Copilot, Amp, Droid, Hermes, and compatible local logs. It visualizes token usage as a 2D or 3D GitHub-style contribution graph. Built with Tauri 2 (Rust + React/Vite), distributed via Homebrew and GitHub Releases. Apple Silicon, macOS 11+. MIT licensed.

Tokcat is a Tauri 2 app with an in-process Rust local-usage reader. The menu-bar cat icon shows today's token count or USD cost; clicking it opens a frosted-glass popover with a contribution graph, per-client filters, streak summaries, and a Settings panel. The app reads supported client logs on-device, never makes a network request other than its updater manifest, stores no telemetry, and requires no account.

## Install

- [Homebrew (one command)](https://github.com/handlecusion/tokcat/blob/main/README.md#quick-start): `brew tap handlecusion/tokcat && brew install --cask tokcat`
- [DMG download](https://github.com/handlecusion/tokcat/releases/latest): direct `.dmg` from GitHub Releases
- [Homebrew tap source](https://github.com/handlecusion/homebrew-tokcat): the cask repo (`Casks/tokcat.rb`)

## Core docs

- [README](https://github.com/handlecusion/tokcat/blob/main/README.md): full English documentation
- [README (Korean)](https://github.com/handlecusion/tokcat/blob/main/README.ko-KR.md): 한국어 문서
- [Releases](https://github.com/handlecusion/tokcat/releases): version history and signed artifacts
- [Updater manifest](https://github.com/handlecusion/tokcat/releases/latest/download/latest.json): consumed by the in-app Tauri updater

## Architecture

- [Tauri shell source](https://github.com/handlecusion/tokcat/tree/main/src-tauri): Rust backend, native tray, animation frames
- [Frontend source](https://github.com/handlecusion/tokcat/tree/main/src): React + Vite, react-three-fiber 3D graph
- [tokscale upstream](https://github.com/junhoyeo/tokscale): reference project for supported local log formats

## Supported AI clients

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

## Privacy

No telemetry. No cloud sync. No account. Network access is limited to the GitHub Releases updater manifest (`latest.json`) checked every 30 minutes. All token data is read locally from session logs on disk.