adntgv

adntgv / claude-usage-systray

Public

macOS menu bar app showing real-time Claude.ai plan usage (session %, weekly %, Sonnet %)

19
1
100% credibility
Found Mar 20, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A macOS menu bar app that displays real-time Claude.ai usage stats like session and weekly limits directly from your secure login.

How It Works

1
🔍 Find the app

You're chatting with Claude.ai a lot and want a quick way to check your usage limits without opening a browser every time.

2
📥 Get the app

Download the ready-to-use app file from the releases page, unzip it, and drag it to your Applications folder on your Mac.

3
✅ Prep your Claude login

Install the Claude Code app if you haven't and sign in there – it keeps everything secure and ready.

4
📊 Spot usage in menu bar

A colorful pie chart icon pops up in your Mac's top menu bar, instantly showing your session and weekly usage percentages that change as you get closer to limits.

5
⚙️ Tweak settings

Click the icon to peek inside, switch display styles, set color warnings, and enable pop-up alerts for high usage.

6
🔄 Watch it update

The numbers refresh automatically every few minutes, with time until reset so you know when limits refresh.

🎉 Usage always in sight

Now you effortlessly track your Claude limits from the menu bar, get timely alerts, and avoid running out mid-conversation.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-usage-systray?

This Swift-built macOS menu bar app displays real-time Claude.ai plan usage right in your menu bar—session percentage (5h reset), weekly total, and Sonnet model breakdown—without firing up a browser. It pulls data via the Claude Code OAuth token stored in your Keychain, coloring icons and text based on custom warning/critical thresholds you set. Install via Homebrew cask, direct download from GitHub releases, or build from source with Xcode.

Why is it gaining traction?

Unlike browser tabs or clunky dashboards, it lives in your macOS menu bar alongside other apps like GitHub Desktop or SSH key managers, toggling compact mode to squeeze "35% · 71%" next to icons without crowding your bar. Notifications ping when you hit limits, and popover details include reset timers plus quick links to refresh or open the full console. For macOS GitHub runners or CLI users pairing code with Claude, it's a zero-setup glance at quotas.

Who should use this?

Heavy Claude Pro users on macOS who burn through weekly limits during coding marathons, especially those integrating AI via Claude Code alongside GitHub workflows. Frontend or backend devs tracking Sonnet usage to avoid throttling mid-project. Skip if you're not on macOS 13+ with Claude Code installed.

Verdict

Grab it if you're a Claude fiend—the Homebrew install is smooth, docs cover builds/tests, and MIT license keeps it open. At 19 stars and 1.0% credibility score, it's early but functional for niche needs; watch for API changes since it hits an undocumented endpoint.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.