Support
Something not working, or a question? Open an issue and you'll get an answer there.
Connecting Claude
Click Connect next to Claude and choose your ~/.claude folder. QuotaPeek adds a small helper to Claude Code's settings, so its usage numbers update after each Claude Code reply. Disconnect puts your settings back.
Connecting Codex
Click Connect next to Codex and choose ~/.codex/sessions. Numbers update after each Codex turn on your Mac.
Connecting Grok
Grok's weekly limit comes from Grok Build, signed in with your Grok subscription. Click Connect next to Grok and choose ~/.grok/logs. Numbers update after each Grok Build prompt. Grok used only in the X app or on grok.com can't be shown.
API balances
In Settings › Providers, choose Add Key next to OpenRouter, DeepSeek or xAI. Keys stay in your Keychain and are sent only to that provider. Balances refresh every 30 minutes.
Free and the unlock
QuotaPeek is free for one plan. A one-time purchase unlocks every plan, week charts, API balances, alerts and the plan-value audit, on your Mac and your iPhone; the supporter purchase unlocks the same and gives a little more. Other plans you connect stay connected and show once you unlock. To move it to another Mac, or after reinstalling, choose Restore Purchases in Settings › General (on the iPhone, in the unlock screen).
How Claude's numbers stay current
After each Claude Code reply, in Terminal, the Claude app or an IDE, QuotaPeek's helper asks Claude Code for its usage, the same numbers /usage shows. If Claude says "Waiting", send one message in Claude Code.
"The Claude app is on another account"
The Claude app signs in on its own, and Claude Code, where QuotaPeek gets Claude's numbers, is signed in to another account. To follow the app, sign Claude Code in to the app's account once, in a second profile: in Terminal, run CLAUDE_CONFIG_DIR=~/.claude-2 claude auth login. From your next Claude reply, QuotaPeek shows the account the Claude app is on, also after you switch accounts in the app.
Connect says "Choose ~/.grok/logs"
Each plan only connects to its own tool's folder, so a folder picked by mistake isn't used. The folder appears once you've used that tool on this Mac.
A plan says "Waiting"
The plan is connected but hasn't produced numbers yet. Use Claude Code, Codex or Grok Build once and they appear.
After a reset
When a window resets, QuotaPeek shows "—" and when it reset ("Reset 8:41 AM") instead of guessing 0%. New numbers arrive the next time you use that tool. Between sessions, Claude's 5 hours shows "Not started".
The arrow under a meter
From version 1.1, each limit is a ten-block meter with a small arrow under it, where you'd be if you used that window evenly. Lit blocks past the arrow mean you're using it faster than time passes. When that pace would run the window out before it resets, the meter turns orange and the line says when, as an estimate: "Out 11:20 AM".
Week charts
With Premium, click a plan (tap it on the iPhone) to see this week against your usual pace and the limit. Every point is a reading the tool reported. Codex and Grok charts start from their logs; Claude's fills in from the day you first run 1.1, and its usual pace appears after a full week.
QuotaPeek on iPhone
Plans come from QuotaPeek on your Mac through your iCloud account, so keep QuotaPeek running there (Settings › General › Open at login). If the iPhone says "Waiting for your Mac", wake the Mac and open QuotaPeek there. API balances can also be read on the iPhone itself: tap API Keys and add a key, which stays in the iPhone's Keychain. With Premium, a Usage tab shows the last 7 or 30 days of your Claude Code and Codex use at API prices; it appears a few minutes after the Mac first counts.