Service: "Claude Code-credentials"
This is the entry created by the official Claude Code CLI when you log in. The app:
1. Only reads - never writes, modifies, or deletes any keychain data
2. Only accesses this one service name - cannot read any other passwords, keys, or credentials
3. Extracts only the OAuth access token - used to call api.anthropic.com/api/oauth/usage
4. Sends data only to Anthropic's API - no analytics, no third-party servers
The token never leaves your machine except to Anthropic's own API endpoint. You can verify this yourself - the entire source is ~400 lines of Swift: https://github.com/richhickson/claudecodeusage
macOS will also prompt you the first time the app tries to access this keychain entry, giving you control to allow or deny.
Funny thing I went down a rabbit hole, cause I first scanned the open PRs and saw a PR to enable universal builds to support intel macs but the whole thing was pure AI slop and someone commented that codexbar already supports intel, and sure enough v.15 added it (the AI slop PR completely missed that), I then looked into the cask script and it has a hardcoded dependency on arm which prevents brew from installing v.17 even if it's already an universal binary since v.15.
This is a great idea and a useful one for avoiding having to monitor Claude's consumption.
I've often exceeded the limit mid-process. If I'm not mistaken, something like this already exists, but I like the graphics and how the information is displayed.
Congratulations!
This looks great. What am I doing wrong? I downloaded it, installed, but all I see is a red X in the toolbar. When I click on it, it says "Authentication expired. Run 'claude' to re-aut..." so I run claude in terminal and still nothing...
Just yesterday I was trying to figure out a method to accurately estimate my remaining usage for the five hour sessions for a shell script. It wasn't until I pointed Claude at your repo and had it make something based off of that that I got it to work well.
I tried another alternative yesterday as I found myself hitting that /usage command too often and it didnt work too well but yours worked straight out of the box! Great job!
I built another tool that should have really been part of the core Claude Code CLI (which you may or may not find useful): https://github.com/agentic-utils/ccs
It lets you search and resume past Claude code conversations from anywhere.
Use Hammerspoon [0][1], it comes with a lot of macOS integrations out of the box and you write Lua, which takes zero effort to pick up and use. For me a big benefit is that you don't need to touch Xcode at all.
Speaking of the macOS menu bar, is there some way to make it overflow into a hidden area behind an "expand" button that would appear when there is no more room, like the notification area in Windows does?
The macOS UI decision of "just pretend that whatever doesn't fit to the right of the notch doesn't exist" is baffling.
I've seen a few apps that claim to do that, but it's always done in some really hacky way (such as needing screen recording permissions), and the behavior is never that of simple overflow handling. Instead they have "always hidden" sections and things like that, which is not what I want.
I used CC just yesterday to build a native MacOS menu bar app by using plan mode (opus) until there was alignment then to edit mode for the build (I use Zed for the prompting).
CC walked me through the needed Xcode project setup and handled all of the code there after.
I’m sure something more complex would be more challenging but I was happy with a two-shot result for this native menu bar app.
I wonder if it's because they don't see other relevant low-cost/overhead solutions. "Follow me on facebook" certainly isn't going to be a win. "Follow me on Bluesky or Mastadon" is going to be ignored. "You can see my comments on insta" won't be relevant. "My TikTok is where it's at" might get you some young followers.
Other solutions (your own blog, medium, substack, etc), all come with more overhead and setup.
I guess that depends on the scope. For people who like that flavor of social media, Twitter was where it was at, and X remains the main place. But if the scope is 'of all people' then of course it is not true -- most of us (myself included) never got into Twitter or any of the similar social media sites.
Plenty of us hated Twitter well before Elon renamed it.
Thank you!
I built another tool that should have really been part of the core Claude Code CLI (which you may or may not find useful): https://github.com/agentic-utils/ccs
It lets you search and resume past Claude code conversations from anywhere.
Doesn't support the "from anywhere" part, but the resume strategies are pretty cool.
[0] https://github.com/pchalasani/claude-code-tools#aichat-sessi...
Are there any others?
Do I just not need one (claude code can do it without a starter template at all)?
[0] https://www.hammerspoon.org
[1] https://www.hammerspoon.org/docs/hs.menubar.html
The macOS UI decision of "just pretend that whatever doesn't fit to the right of the notch doesn't exist" is baffling.
I've seen a few apps that claim to do that, but it's always done in some really hacky way (such as needing screen recording permissions), and the behavior is never that of simple overflow handling. Instead they have "always hidden" sections and things like that, which is not what I want.
I used CC just yesterday to build a native MacOS menu bar app by using plan mode (opus) until there was alignment then to edit mode for the build (I use Zed for the prompting).
CC walked me through the needed Xcode project setup and handled all of the code there after.
I’m sure something more complex would be more challenging but I was happy with a two-shot result for this native menu bar app.
Why... just why? Why do people keep insisting on using it?
I wonder if it's because they don't see other relevant low-cost/overhead solutions. "Follow me on facebook" certainly isn't going to be a win. "Follow me on Bluesky or Mastadon" is going to be ignored. "You can see my comments on insta" won't be relevant. "My TikTok is where it's at" might get you some young followers.
Other solutions (your own blog, medium, substack, etc), all come with more overhead and setup.
https://github.com/richhickson/claudecodeusage/blob/0bb26c05...
(Yes, this is sarcasm)