Troubleshooting

A pasted token can't auto-renew, so it eventually expires. When that happens the card flags it and you get a notification. Use replace token on that account to paste a fresh one from claude setup-token. The red state is deliberate — it stops a stale token from silently zeroing your data.

The statistics window only reflects sources you've configured. No Claude account means no Claude data — the panel never shows numbers you didn't set up. Add the account (see Configuration) and its data appears.

Codex is read locally from ~/.codex/sessions. If no card appears, make sure the Codex app is logged in and has written at least one session there — QuotaLens makes no network call for Codex, so it can only show what's on disk.

A self-built or DMG copy isn’t notarized, so Gatekeeper may quarantine it. Clear the attribute and reopen:

xattr -dr com.apple.quarantine /Applications/QuotaLens.app

The Homebrew cask and building from source both avoid this. See the download page for all three routes.

Threshold alerts (80 / 90 / 100%) are on by default, but macOS still has to allow them. Check System Settings → Notifications → QuotaLens, and confirm the toggle is enabled in QuotaLens Settings. Each threshold only fires once per window by design.

Everything runs locally. The only network call is the Claude probe — a minimal, throttled request (max_tokens: 1, at most once every five minutes) used solely to read the rate-limit headers. Tokens are stored locally in UserDefaults; nothing else leaves your machine.

Open an issue on GitHub — include your macOS version and which source is affected.