dependentsign

dependentsign / ClaudeUsageWidget

Public

macOS desktop widget (WidgetKit) for monitoring Claude AI usage limits and reset times

26
4
100% credibility
Found Apr 06, 2026 at 26 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A macOS desktop widget displaying real-time progress bars, color-coded usage levels, and reset countdowns for Claude AI's session and weekly limits.

How It Works

1
🔍 Find the Widget

You hear about a handy Mac desktop gadget that tracks your Claude AI usage limits with colorful bars and timers right on your screen.

2
💾 Get It Ready

Download the files and follow simple Mac instructions to build and install the little app on your computer.

3
🔗 Connect to Claude

Open the app, pick your preferred way to link it securely to your Claude account, like using a special access code from your browser.

4
✨ Save Your Setup

Enter your details, save them safely in a private spot on your Mac, and feel excited as everything connects.

5
🖥️ Add to Desktop

Right-click your desktop, choose to edit widgets, search for Claude, pick a size, and place it where you like.

6
⏰ Watch It Update

The widget refreshes every few minutes, showing green-to-red progress for your 5-hour and weekly limits with reset countdowns.

✅ Stay in Control

Now you always know your Claude usage at a glance, avoiding surprises and planning your AI chats perfectly.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 26 to 26 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 ClaudeUsageWidget?

ClaudeUsageWidget is a Swift-powered macOS desktop widget using WidgetKit to monitor Claude AI usage limits directly on your desktop. It displays progress bars for 5-hour sessions and weekly quotas, color-coded from green to red, plus reset countdowns across small, medium, and large sizes. Auto-refreshes every 5 minutes via OAuth token or session key, solving the hassle of digging into claude.ai dashboards.

Why is it gaining traction?

Native macOS desktop widgets deliver glanceable Claude stats without apps or browsers, beating web tabs or CLI checks. Dual auth supports Pro/Team plans flexibly, with a config UI and JSON setup for quick GitHub macOS client integration. Visual bars and timers hook power users tired of surprise rate limits mid-prompt.

Who should use this?

Claude Pro subscribers on macOS 15+ who hammer AI for coding or research, needing desktop widgets for quota awareness. Suits developers juggling GitHub desktop, macOS GitHub CLI, or SSH GitHub macOS workflows, wanting a persistent macOS desktop manager for AI limits alongside macOS desktops and shortcuts.

Verdict

Solid for niche needs with excellent docs and MIT license, but 19 stars and 1.0% credibility score signal early maturity—build it yourself via Xcode if Claude tracking fits your flow. Skip if not on Sequoia or preferring browser extensions.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.