gxjansen

gxjansen / claude-code-meter

Public

macOS desktop widget showing Claude Code usage limits (5-hour and 7-day windows) in real time. Built for Ubersicht.

84
10
100% credibility
Found Feb 17, 2026 at 79 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

A macOS desktop widget that displays real-time Claude Code usage for 5-hour and 7-day windows with progress bars, percentages, reset times, and toggleable display modes.

How It Works

1
💡 Discover the usage tracker

You hear about a simple desktop gadget that shows your Claude Code usage limits live on your Mac screen to help you stay productive.

2
📱 Get the widget display tool

Download and install Ubersicht, a free app that lets you put helpful widgets on your Mac desktop.

3
📥 Add the meter widget

Grab the ready-made file with one easy download, drop it into your widgets folder, and watch it appear on your screen.

4
🔐 Connect your Claude account

Run a quick sign-in for Claude Code on your Mac so the widget can peek at your usage safely from your stored login.

5
📊 See your usage at a glance

Beautiful progress bars light up in green, amber, or red, showing percentages left or used, plus exact reset times and countdowns.

6
🔄 Switch views or adjust spot

Click the top badge to flip between remaining or used views, and tweak the position for wherever it feels right on your desktop.

✅ Monitor limits effortlessly

Now your Claude Code usage is always visible, helping you plan your work without surprises or constant checking.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 79 to 84 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-code-meter?

Claude-code-meter is a JavaScript widget for Ubersicht that displays your Claude Code usage limits as a real-time macOS desktop widget, tracking both 5-hour and 7-day rolling windows with progress bars, percentages, reset times, and countdown timers. It solves the pain of guessing when you'll hit Anthropic's rate limits during heavy Claude Code sessions—no more digging through apps or terminals for claude code usage meter stats. Install via curl into your Ubersicht folder, and it pulls data straight from Anthropic's OAuth API using your existing Keychain token.

Why is it gaining traction?

It stands out with toggleable display modes—remaining capacity (draining bucket) or used (filling counter)—plus color-coded bars that shift from green to red as limits near, giving instant visual feedback on your macOS desktop widgets setup. Developers love the zero-config auth, 30-second refresh, and clickable header to switch views, all without leaving your workflow. Compared to browser tabs or CLI checks, this claude code meter hooks you with always-on monitoring right on your macOS desktops.

Who should use this?

Claude Pro or Max subscribers on macOS who hammer Claude Code for code generation and hit limits daily, especially AI tool builders or prompt engineers tracking context windows. It's perfect for macOS desktop manager fans already running Ubersicht, wanting a claude code context meter without extra apps. Skip if you're on Linux/Windows or rarely max out quotas.

Verdict

Grab it if you're deep in Claude Code on macOS—75 stars and solid README make it dead simple to try, despite the 1.0% credibility score signaling early maturity and no tests. Niche but nails the job for Ubersicht users; fork if you need tweaks.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.