Claude Code usage tracker for Mac
Track your Claude Code usage, right in the notch.
Hitting the 5-hour limit mid-task, with no warning, is the worst part of working with an agent. NotchDodo shows you where you stand before it happens.
One-time payment, no subscription. Works on 2 Macs. Key by email in a minute. 14-day refund. How to open it on macOS

Demo data shown.
What the Claude Code usage tracker shows
- Your current 5-hour window: tokens used against your budget, burn rate per minute and when it resets.
- Whether you are on track to finish the window or about to run out.
- Today's tokens and estimated cost, plus a seven day chart.
- Every session: project, git branch, model, messages, tokens and cost.
- Which agents are running right now, which are waiting for you, and which are done.
- A live activity beside the notch while an agent is working, so you see it without opening anything.
- A flash in the notch when your window crosses 80 and 100 percent.
- An alert with the Claude mark the moment Claude Code needs your approval or is waiting for you.
How NotchDodo tracks Claude Code token usage
- 1It reads the logs Claude Code already keeps
Claude Code writes every session to a folder in your home directory. NotchDodo reads those files on your Mac as they change. There is no API key to paste and no account to connect.
- 2It groups your usage into 5-hour windows
A window starts at the hour of your first message and a new one begins after it ends, the same way the open source ccusage tool counts. That gives you tokens used, burn rate and a reset time.
- 3It compares you against a budget
NotchDodo learns a budget from your biggest past window, or uses one you set. From your burn rate it projects whether you will make it to the reset.
- 4It stays one hover away
Hover the notch and open AI Usage. While an agent is running, a small live activity sits beside the notch so you can glance at it without opening anything.
Want an alert when Claude Code needs your approval? Read how to get notified when Claude Code needs your approval on Mac, which covers the free terminal bell and hook options as well as NotchDodo's notch alerts.
Leaving a long run going while you step away? NotchDodo also keeps your Mac awake while Claude Code works and puts it to sleep once the job is done, so the agent never freezes mid-task.
The numbers are estimates. Anthropic does not publish its exact limit counter, and costs use API list prices, which is not how Pro and Max plans are billed. They are accurate enough to plan your next hour, which is the point.
The Claude Code 5-hour limit, explained
On Pro and Max plans, Claude Code usage is metered in session windows. A window opens with your first message and lasts five hours; once you use up its allowance, Claude Code stops until the window resets. Anthropic also applies weekly limits on top. The catch is that nothing tells you how close you are until you hit the wall, usually in the middle of a task.
NotchDodo shows the current window as a bar with your tokens, burn rate per minute and the reset time, and projects whether you'll make it to the reset at your current pace. It covers the 5-hour window; weekly limits are counted on Anthropic's side and aren't in your local logs.
Free ways to check your Claude Code usage
Inside Claude Code, two commands show where you stand:
/usage/usage shows your plan's limits, and /cost shows what the current session has cost when you use an API key. For history from the terminal, the open source ccusage tool reads the same local logs NotchDodo does:
npx ccusage@latest blocks --liveBoth mean stopping to run a command. NotchDodo keeps the same numbers one hover away, all day, and adds sessions, alerts and Codex and Gemini CLI in one place.
Questions
How do I check my Claude Code usage?
In the terminal, Claude Code's /usage command shows your plan's limits and /cost shows the current session's cost when you use an API key. The open source ccusage tool (npx ccusage@latest) reads your local logs for daily totals and the current 5-hour block. NotchDodo reads the same logs and keeps tokens, cost and the 5-hour window in your notch all day, without running a command.
When does the Claude Code 5-hour limit reset?
Five hours after the session window began, which starts with your first message. NotchDodo shows the reset time and a countdown for the current window, and warns you at 80 and 100 percent of your budget.
Is this the same as ccusage?
It counts the same way: NotchDodo groups usage into 5-hour windows like ccusage does. The difference is where you see it. ccusage is a command you run in a terminal; NotchDodo keeps the numbers in your notch, adds per-session detail, alerts when Claude Code needs you, and covers Codex and Gemini CLI.
Does it send my code or prompts anywhere?
No. NotchDodo reads the log files Claude Code already writes on your Mac and does the maths locally. Nothing from those logs leaves your Mac.
Is the 5-hour window exactly what Anthropic uses?
It is an estimate. NotchDodo groups your usage into 5-hour windows the way the open source ccusage tool does, starting at the hour of your first message. Anthropic does not publish its exact counter, so treat the reset time and budget as a close guide rather than an official number.
Where does the token budget come from?
By default NotchDodo learns it from the largest window in your own history. You can also set your own number in Settings if you know your plan's limit.
I'm on a Pro or Max plan. Is the cost real?
Costs are estimates at Anthropic's API list prices. Subscription plans are not billed per token, so on Pro or Max the figure shows what the same usage would cost on the API. It is a useful measure of how hard you are pushing, not a bill.
Does it work with Codex CLI?
Yes. If you use OpenAI's Codex CLI, its sessions and tokens show up alongside Claude Code. Codex costs are not shown because its plan pricing is not published per token.
Can it tell me when Claude Code needs my input?
Yes. Turn on alerts with the bell in AI Usage and the notch flashes with the Claude mark when Claude Code wants you to approve something or is waiting for your next prompt. It clears by itself once you answer. It works through Claude Code's own hooks: one small entry in ~/.claude/settings.json, removed again when you turn alerts off.
Does it work with Gemini CLI?
Yes. Gemini CLI sessions show up with their tokens and an estimated cost at Google's API list prices. They count towards today's totals and the seven day chart, but not the 5-hour window, because Google doesn't limit usage that way.
What about Cursor?
Not yet, and not from logs. Cursor keeps your real token usage on its own servers, and the files on your Mac don't record it, so NotchDodo can't show accurate numbers for it.
Do I have to keep a terminal open?
No. NotchDodo reads the logs whenever they change, so the numbers are there whether or not a session is running. It speeds up while the AI Usage page is open.
What else does NotchDodo do?
AI Usage is one of eighteen tools in the notch, alongside your calendar with one-click meeting join, a Pomodoro timer, music controls, a file shelf, notes, tasks, reminders and more.
Stop finding out from an error message.
One-time $9.99 for 2 Macs. macOS 14 Sonoma or later on Apple silicon. Macs without a notch get a simulated one.
One-time payment, no subscription. Works on 2 Macs. Key by email in a minute. 14-day refund. How to open it on macOS