FAQ

Common questions

Still stuck? The issue tracker is the place to ask.

Which tools does QuotaLens monitor?

Claude and Codex. Claude is tracked per account through its own setup-token; Codex is read locally from ~/.codex/sessions. Both surface the official 5-hour and 7-day limits.

Does it work on Windows or Linux?

No. QuotaLens is a native macOS menu-bar app and requires macOS 13 or newer. There is no Windows or Linux build.

How many accounts can I track?

Up to four sources total. Each Claude account is its own card with its own token; Codex is a single local login.

Is my data sent anywhere?

No. 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.

Why did a Claude card turn red?

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.

Why is my statistics window empty for a tool?

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.

Is it free?

Yes. QuotaLens is open source under the MIT license. The Claude and Codex names and logos are trademarks of their respective owners, used only to identify the tools being monitored.