Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Limit Checker

A macOS menu bar app that shows your Claude.ai usage limits in real-time. Know exactly when you're burning through tokens faster than your rate limit resets — so you can see if you'll end up paying for overages before your window refreshes.

macOS Swift Download

Screenshot

Features

  • Live usage percentage in your menu bar
  • Reset countdown — see exactly when your limits refresh
  • Burn rate indicator — know if you're using tokens faster than the clock is ticking
  • Over-limit warning — clear indicator when you've crossed 100% and are on paid usage
  • Multi-org support — switch between organizations
  • Secure — session key stored locally, API calls via embedded browser engine

Menu Bar Display

☁ 49% 3h44m 🟡1.2x
  • ☁ 49% — current usage percentage
  • 3h44m — time until rate limit resets
  • 🟡1.2x — burn rate (1.2x = using 20% faster than even pacing)

Burn Rate Colors

Color Meaning
🟢 Under 0.8x — well within budget
🟡 0.8x–1.0x — approaching even pace
🟠 1.0x–1.5x — burning faster than time passes
🔴 Over 1.5x — will hit limit before reset

Requirements

  • macOS 14.0 (Sonoma) or later
  • XcodeGen (for generating Xcode project)
  • Xcode 15+

Build

# Install XcodeGen if needed
brew install xcodegen

# Generate Xcode project
xcodegen generate

# Open in Xcode
open ClaudeLimitChecker.xcodeproj

# Or build from command line
xcodebuild -project ClaudeLimitChecker.xcodeproj -scheme ClaudeLimitChecker -configuration Release build

Setup

  1. Build and run the app
  2. Click the ☁ -- icon in your menu bar
  3. Open Settings (⌘,)
  4. Add your Claude.ai session key:
    • Go to claude.ai in your browser
    • Open DevTools (F12 or ⌘⌥I)
    • Go to ApplicationCookieshttps://claude.ai
    • Copy the value of sessionKey
    • Paste it in the app settings

Configuration

Setting Default Description
Refresh interval 60s How often to poll Claude.ai for usage data
Show burn rate On Display burn rate multiplier in menu bar
Rate limit window 5h Duration of one rate limit cycle (adjust for your plan)

How Burn Rate Works

The burn rate compares your actual token consumption speed against the "even pacing" speed — i.e., how fast you'd use tokens if you spread them perfectly evenly across the rate limit window.

  • 1.0x = exactly on pace
  • < 1.0x = you'll have budget left when the window resets
  • > 1.0x = at this rate, you'll exceed 100% before the window resets

The app tracks your usage over time and calculates the trend. It needs a few data points before showing an accurate burn rate.

Privacy

  • Your session key is stored locally in the macOS Keychain
  • The app only communicates with api.claude.ai
  • No data is sent to any third party
  • No analytics or telemetry

License

MIT

About

macOS menu bar app showing Claude.ai usage limits, burn rate & reset timer

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages