Docs
Settings reference
Open the panel, click the gear, and you land in Settings. Here is what every control does, its range, and its default.
Sources
The top of Settings is a unified Sources list. It shows a counter (used / 4) — QuotaLens tracks up to four sources total. Each Claude account is one source with its own pasted token; Codex is a single local login that needs no setup. Every row has a toggle to temporarily disable a source without removing it, and Claude rows expose replace token and delete.
Preferences
| Setting | Range | Default |
|---|---|---|
| Refresh interval | 2 – 60 seconds | 5s |
| 5-hour window | Block (reset) · Sliding | Block (reset) |
| Threshold alerts | On · Off | On |
| Timeline length | hours shown in the panel chart | 24h |
| Diagnostics | Show local − official delta | Off |
| Launch at login | On · Off | Off |
- Refresh interval. How often QuotaLens re-reads local logs and refreshes the menu bar. Claude’s network probe is throttled separately (never more than once per five minutes), so a short interval never increases network traffic.
- 5-hour window. Block mirrors Claude’s own 5-hour block that resets as a unit. Sliding instead sums the rolling past five hours. Pick whichever matches how you think about your limit.
- Threshold alerts. A system notification when any source crosses 80%, 90%, or 100% of a window. Each threshold fires once per window so you are warned, not spammed.
- Timeline length. Controls the “Timeline · last Nh” chart at the bottom of the panel and the per-card sparkline range.
- Diagnostics. A developer view that shows the gap between QuotaLens’ local estimate and the official limit Claude reports. Off by default — most people never need it.
- Launch at login. Registers the app as a macOS login item (via SMAppService) so the gauge is in your menu bar after every restart.
Where settings live
Every preference is stored locally in macOS UserDefaults — including your pasted Claude tokens. Nothing is synced to a server. See Privacy & data for the full picture.