whatisgithub

What is claudeusage_latest_may2026?

aiduckman/claudeusage_latest_may2026 — explained in plain English

Analysis updated 2026-05-18

0SwiftAudience · vibe coderComplexity · 2/5LicenseSetup · easy

In one sentence

A macOS menu bar app that shows your live claude.ai usage limits with color coded warnings and threshold notifications.

Mindmap

mindmap
  root((ClaudeUsage))
    What it is
      macOS menu bar app
      Live usage tracker
      Color coded warnings
    Tech stack
      Swift
      SwiftUI
      AppKit
    Use cases
      Watch 5 hour window
      Watch 7 day window
      Get threshold alerts
      Auto launch at login
    Audience
      Claude power users
      Vibe coders
    Setup
      Download release zip
      Bypass quarantine
      Paste sessionKey

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep an eye on your 5 hour and 7 day claude.ai usage limits without opening the website.

USE CASE 2

Get a notification before you run out of your Claude usage window.

USE CASE 3

Have the app launch automatically at login so usage is always visible.

What is it built with?

SwiftSwiftUIAppKit

How does it compare?

aiduckman/claudeusage_latest_may2026arnabau/thermalpulsecaggann/claude-code-monitor
Stars000
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Uses claude.ai's internal, undocumented usage endpoint, so it could break if that changes.

So what is it?

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.

Copy-paste prompts

Prompt 1
Walk me through downloading and installing ClaudeUsage on my Mac, including the quarantine bypass step.
Prompt 2
Help me find my Organization UUID and sessionKey from claude.ai to set up this app.
Prompt 3
Explain how to build ClaudeUsage from source using Xcode and XcodeGen.
Prompt 4
Show me how to change the notification thresholds in this app's settings.

Frequently asked questions

What is claudeusage_latest_may2026?

A macOS menu bar app that shows your live claude.ai usage limits with color coded warnings and threshold notifications.

What language is claudeusage_latest_may2026 written in?

Mainly Swift. The stack also includes Swift, SwiftUI, AppKit.

How hard is claudeusage_latest_may2026 to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claudeusage_latest_may2026 for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.