Docs

Configuration

Everything you can set up — accounts, sources, tokens, and launch behaviour.

Adding Claude accounts

Each Claude account is added with its own token and becomes its own card:

  1. 1Run claude setup-token in a terminal for the account and copy the token.
  2. 2Open QuotaLens → the gear icon → Sources → Add Claude account.
  3. 3Name it (e.g. Pro, Max 5x) and paste the token.
bash
claude setup-token

Sources and limits

QuotaLens tracks up to four sources total. Run a Pro account, a Max 5x account, and Codex side by side — each gets its own card with its own authoritative limits. Codex counts as a single local login; every Claude account counts as one source.

Codex

Codex needs no configuration. QuotaLens reads its official rate_limits directly from ~/.codex/sessions/**/*.jsonl — entirely local, with no network call at all.

Replacing an expired token

A pasted token can't auto-renew. When one expires the card turns red and you get a system notification. Use replace token on that account to paste a fresh one from claude setup-token — so a stale token never silently zeroes your data.

Statistics stay in sync

The statistics window reflects only the sources you've configured. No Claude account means no Claude data — the panel never shows numbers you didn't set up. Pick Today / 3d / 7d / 30d / All or a custom range; short ranges render hourly.

Threshold notifications

QuotaLens can post a system notification when any source crosses 80%, 90%, or 100% of a window. Each threshold fires once per window, so you get a heads-up without being spammed. It's on by default; toggle it in Settings.

Launch at login

Optionally have QuotaLens start with your Mac — it's a toggle, backed by macOS's SMAppService. Every preference here is covered in full on the Settings reference.

Next: Settings reference