Docs

Getting started

QuotaLens is a macOS menu-bar gauge for Claude and Codex quotas. It reads the authoritative limits your tools enforce and keeps everything on your machine.

What it does

QuotaLens lives in your menu bar as a small ring plus a percentage of your highest current usage. Click it for a panel with one card per source — the authoritative 5-hour and 7-day limits, your current session, and a 24-hour timeline. A separate statistics window breaks down tokens, cost, and cache over any range.

It tracks two tools side by side:

Claude — one card per account, each probed with its own claude setup-token.
Codex — read locally from ~/.codex/sessions, no network.

Pick a guide

Quick start

Install, paste your first token, and see a live gauge in about five minutes.

Configuration

Add Claude accounts, name your sources, replace expired tokens, launch at login.

Settings reference

Every preference explained — refresh interval, window mode, alerts, diagnostics.

Statistics window

Token, cost, and cache history across Today, 3d, 7d, 30d, All, or a custom range.

How it works

Where every number comes from — Claude’s headers and Codex’s local rate_limits.

Privacy & data

What stays on your Mac, what leaves, and the single throttled network call.

Troubleshooting

Red cards, empty statistics, missing Codex data — and how to fix each.