Support — QuotaGlance

Email support[email protected]. Questions about setup or anything else. Report a bugInclude your macOS and QuotaGlance versions. PrivacyWhat QuotaGlance reads, and what it never does.

Getting started

Open QuotaGlance. It lives in the menu bar, with no Dock icon. Press ⌃⌥U to open it from any app.
In the first-run window, choose the accounts to track: Claude, ChatGPT (Codex) or both.
That's it. Hover over an account in the menu bar for details, or click for the full menu.

How fresh are the numbers?

QuotaGlance never asks Anthropic or OpenAI for your usage, so there's no sign-in and no API key. Claude Code, the Claude desktop app and Codex already keep track of your usage on your Mac, and QuotaGlance shows each new reading the moment they save it.

Claude: about every 5 minutes while the Claude desktop app is open, because that's how often the app checks. QuotaGlance also updates immediately when you open Claude's usage panel or Claude Code checks your usage, for example with /usage.
ChatGPT (Codex): after every Codex reply, whether you use the CLI, the IDE extension or the Codex app.
Reset times: shown for each limit. When a limit resets, QuotaGlance shows it as full right away.
“Updated 2 min ago”: when your provider measured the numbers, not when QuotaGlance last looked.

Claude not updating? Keep the Claude app open, or open its usage panel. Your limits are shared across your account, so usage from claude.ai or your phone counts too.

Local webhook

Using other tools? Any script or app on your Mac can send usage numbers to QuotaGlance. Turn on the webhook in Settings › Accounts › Advanced. It listens on 127.0.0.1 only. Copy gives you a ready-to-run command:

curl -X POST http://127.0.0.1:47823/v1/usage \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider":"claude","plan":"Max",
       "five_hour":{"remaining_percent":72,"resets_at":"2026-11-01T19:51:00Z"},
       "weekly":{"remaining_percent":48}}'

provider is claude or chatgpt. Each window takes remaining_percent or used_percent (0–100) and an optional resets_at.

Shortcuts

⌃⌥U opens the menu from anywhere.
In the menu: ⌘R refreshes, ⌘, opens Settings, ⌘Q quits.

Before you write

In Settings › Help, click Copy diagnostics and paste it into your email. It has your versions and last errors, never tokens.
Never send tokens, passwords or payment details.