Guide
How to track token usage on macOS
Token counts drive every dollar. Here is how to watch them on macOS without sending anything to a server.
Where the tokens live
Claude Code records `input_tokens`, `output_tokens`, `cache_read_input_tokens`, and `cache_creation_input_tokens` (split into 5-minute and 1-hour) in its JSONL transcripts. Codex records rate-limit percentages in its rollout logs. Both are already on your Mac.
A glanceable readout
JP the Cat parses those files locally and keeps a live menu-bar figure, a macOS widget, and a dashboard with per-model and per-day breakdowns. It tracks Claude Code, Codex, and Grok from their session logs, and Muse Spark from OpenCode muse-spark rows on this Mac (not your full Meta account dashboard); 59 more providers are on the roadmap.
Common questions
- Does tracking token usage upload my code?
- Not with JP the Cat — it only reads local usage logs. Prompts, code, and transcripts never leave your Mac.
See your real numbers with JP the Cat
A light, local menu-bar meter for Claude Code, Codex, Grok, and Muse Spark — real cost, honest limits.
Download MeowPrefer Homebrew? Install the same signed, notarized app from JP's public tap.
brew tap 8bittts/jpthecat
brew trust 8bittts/jpthecat
brew install --cask jpthecat