aiduckman/claudeusage_latest_may2026 — explained in plain English
Analysis updated 2026-05-18
Keep an eye on your 5 hour and 7 day claude.ai usage limits without opening the website.
Get a notification before you run out of your Claude usage window.
Have the app launch automatically at login so usage is always visible.
| aiduckman/claudeusage_latest_may2026 | arnabau/thermalpulse | caggann/claude-code-monitor | |
|---|---|---|---|
| Stars | 0 | 0 | 0 |
| Language | Swift | Swift | Swift |
| Setup difficulty | easy | moderate | easy |
| Complexity | 2/5 | 3/5 | 2/5 |
| Audience | vibe coder | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Uses claude.ai's internal, undocumented usage endpoint, so it could break if that changes.
ClaudeUsage is a small macOS menu bar app that shows how much of your claude.ai usage allowance you have used, right at the top of your screen. It tracks the rolling 5 hour session window, the 7 day weekly window, and, if your plan includes one, the Opus specific weekly window. The percentage shown in the menu bar changes color as you get closer to your limit, staying its default color under 70 percent, turning orange between 70 and 89 percent, and turning red at 90 percent or higher. It also sends a notification once you cross 80 percent and again at 95 percent of a given window, without repeating constantly. To work, the app needs two pieces of information from your claude.ai account: an organization identifier and a session key, both of which you copy from your browser using the developer tools. A built in three step welcome tour walks a first time user through finding and pasting these values, and it can be reopened later from the settings menu. The session key is stored in the macOS Keychain rather than as a plain file, and it eventually expires, at which point you paste in a fresh one. The app checks for updated numbers about once a minute, though you can force a refresh manually, and it can optionally launch automatically when you log into your Mac. The README is direct that it relies on an internal, undocumented endpoint the claude.ai website itself uses to show your usage page, not an official published API, so it could stop working if that changes. Installing it does not require Xcode. You download a prebuilt zip file from the project's releases, drag the app into your Applications folder, and since it is not signed with a paid Apple developer certificate, you clear a macOS security flag with a short terminal command or an approval dialog before it will open. Building it yourself instead requires Xcode, Homebrew, and a tool called XcodeGen. The project is released under the MIT license.
A macOS menu bar app that shows your live claude.ai usage limits with color coded warnings and threshold notifications.
Mainly Swift. The stack also includes Swift, SwiftUI, AppKit.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly vibe coder.
This repo across BitVibe Labs
Verify against the repo before relying on details.