Blog

Track Claude Code and Codex limits on your Mac

QuotaBuddy puts your Claude and ChatGPT usage limits in the Mac menu bar, so you can see what’s left before Claude Code or Codex stops mid-task. This guide is for people who spend their day in those two agents. It covers setup, reading the figures, alerts, analytics and conversations.

Install and open QuotaBuddy

QuotaBuddy needs macOS 26 or later. Download it, move it to your Applications folder and open it.

On first launch, the Welcome to QuotaBuddy window walks you through a short setup:

  1. Find Your Tools checks whether Claude Code and Codex are installed and signed in. Neither is required for tracking, but analytics and conversations come from their logs.
  2. Add Your Accounts brings in your logins, as described below.
  3. Stay Ahead of Limits asks macOS whether QuotaBuddy may send notifications.
  4. Make It Yours sets whether QuotaBuddy opens at login, what the menu bar shows and when it appears in the Dock.

To look around first, click Set Up Later. Help › Setup Checkup… covers the same ground whenever you’re ready.

QuotaBuddy then lives in your menu bar as a small gauge. A full menu bar can hide icons, so if you can’t see it, open QuotaBuddy from Applications or Spotlight.

Add your Claude and ChatGPT accounts

Add as many accounts as you use. There are two ways to add each one.

Import the login your agent already uses. If Claude Code or Codex is signed in on this Mac, click Import from Claude Code or Import from Codex during setup, or use File › Import Login later. For Claude, macOS asks whether QuotaBuddy may read Claude Code’s saved login. Choose Always Allow so it doesn’t ask again. For Codex, QuotaBuddy copies the login from ~/.codex/auth.json. Importing changes nothing for either tool.

Sign in with your browser. Use this for accounts your agent isn’t signed in to. Click Sign In with Browser… or Sign In to Another Account… during setup, or choose File › Add Account… (⌘N) in the main window. Then:

  1. Sign in on the page that opens in your browser.
  2. Approve the request. QuotaBuddy receives a token, never your password.
  3. Come back to QuotaBuddy. The sheet finishes on its own.

Logins stay in your Keychain, and usage checks spend no quota.

Read the menu bar and the panel

The gauge’s needle shows your active Claude account’s session or weekly window, whichever is closer to its limit. Next to it is the session figure by default. The gauge shows an exclamation mark when the account is nearly at its limit or needs you to sign in again.

To change this, open Settings › General. Next to the icon offers Icon only, Session usage, Weekly usage and Session and weekly. Show usage for picks your active Claude or ChatGPT account.

Click the gauge to open the panel, or press ⌃⌥⌘U from any app. A checkmark marks the account each agent is using now. Each account has bars for:

  • Session, the 5-hour window.
  • Weekly, the 7-day window.
  • Any per-model limits the account reports.

If a plan has only a weekly limit, the panel shows the Weekly bar on its own. Set Next to the icon to Weekly usage or Session and weekly so the menu bar shows it too.

Figures show the percent used. To show what’s left instead, set Show usage as to Percent left in Settings › General.

Under each bar, “Resets in” counts down to the reset. Hover for the exact time. A bar turns orange when it’s at least half used and your current pace would nearly use it up before the reset. It turns red when it’s nearly full. If the window would run out before it resets, an orange line such as “Runs out in ~1h 10m” appears.

For a shorter panel, click the compact button at the top (“Show a compact list”). Each account becomes one row of percentages, and hovering over a row shows when each window resets.

Set up alerts

If you skipped notifications during setup, turn on Send notifications in Settings › Notifications. Then choose your alerts:

  • An account is on course to run out warns you when your current pace would use up a window before it resets. Warn ahead by sets how early: 15 minutes, 30 minutes, 1 hour or 2 hours.
  • Warn before a reset, under Before Quota Goes Unused, nudges you when a window is about to reset with quota still unused. Choose from 10 minutes to 2 hours ahead, and use the slider to set how much must be unused.
  • An account hits its limit, A limit resets and An account needs you to sign in again each have their own switch.

Quiet hours skips notifications during the hours you pick. To pause for a while instead, click the gear in the panel and choose Pause Notifications.

Optional extras

The quotabuddy command and a status line

In Settings › Advanced, find Command-Line Tool and click Install. This prints every account’s usage, with the active account marked *:

quotabuddy

This prints one short line, such as Claude 38% · 6%wk GPT 2%wk, for a shell prompt or Claude Code’s status line:

quotabuddy statusline

To use it in Claude Code, set the statusLine command in your Claude Code settings to quotabuddy statusline.

Analytics

Choose Analytics in the main window’s sidebar. It reads the session logs Claude Code and Codex keep on this Mac, and nothing is sent anywhere. Each agent gets charts of token use by model and project, the hours you work, and each account’s weekly limit over time.

Hand a conversation to the other agent

Conversations lists your Claude Code and Codex sessions on this Mac. When one agent runs out mid-task, select the conversation and click the Continue in button, such as Continue in Codex CLI. The other agent opens and reads the earlier conversation. Under Then, choose Load context and wait or Continue the work.

Let your agents search past conversations

QuotaBuddy can also answer Claude Code and Codex directly, through an MCP server that runs on this Mac. In Settings › Coding Agents, turn on Let coding agents use QuotaBuddy, then click Connect next to each agent. An agent can then look up how much quota is left and search or read your earlier conversations, in either agent.

Under What Agents Can See, choose which agents’ conversations to share, and whether that’s All indexed conversations or Only conversations I hand off. Hide keys and passwords is on by default, and Never share from these folders keeps a project out entirely. QuotaBuddy’s tools only read. Whatever an agent reads goes to its provider with the rest of that conversation.

After the trial

Every feature is free for 14 days, with no sign-up. In the trial’s last week, the panel shows how many days are left. After that, QuotaBuddy needs a one-time license, and you enter your key in Settings › License. The license page covers activating and moving to a new Mac, and the FAQ answers other questions.