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 and Codex today; 60 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 and Codex — real cost, honest limits.

Download Meow