Token Meter

macOS menu bar app for monitoring Claude Code and Codex usage from one compact popover

---

What is Token Meter?

Token Meter lives in your macOS menu bar and shows coding-agent usage at a glance. It currently supports:

• Claude Code
  • Session usage (5-hour window)
  • Weekly usage (7-day window)
  • Per-project token breakdown
  • Reset countdown
• Codex
  • Current session usage from local Codex session snapshots when available
  • Availability/login-required fallback when no local session metric is available
  • Per-project token breakdown from local Codex artifacts

For Claude, Token Meter reads your Claude Code OAuth credentials and displays:

• Session usage (5-hour window) - Current usage percentage with color-coded gauge
• Weekly usage (7-day window) - Weekly consumption tracking
• Per-project token breakdown - See which projects consume the most tokens
• Reset countdown - Time remaining until your session limit resets

For Codex, Token Meter reads local Codex state on your Mac and shows project usage plus the current session usage or availability/login status.

Screenshots

Menu Bar	Usage View	Project Breakdown
Shows current session %	Color-coded usage gauges	Token usage per project

Installation

Homebrew (Recommended)

brew install --cask younghyundev/tap/token-meter

Troubleshooting: "App is damaged" error

If you see a "damaged" warning when opening the app, run:

xattr -cr /Applications/TokenMe