Back to browse
GitHub Repository

Native macOS WidgetKit widget for monitoring Claude Code rate limits

4 starsSwift

Claude Rate Widget Native macOS Widget to Monitor Claude Code Limits

by hulryung·Feb 16, 2026·1 point·0 comments

AI Analysis

●●SolidNiche GemSlick
The Take

Shows all four Claude limits (Session, Weekly, Weekly Sonnet, Overage) in one widget with color-coded warnings and reset countdowns — exactly the tiny UX gap heavy users kept bumping into. The author went native: Swift + WidgetKit, OAuth PKCE (no API keys), App Group UserDefaults for widget/app sync and a Homebrew tap for install — practical choices that make this something you'd actually run on your desktop. Limited to macOS Sonoma and Claude subscribers, so great for the audience but narrow in reach.

Category
Target Audience

Mac users who use Claude Code/Claude Max heavily (developers, AI researchers, power users)

Post Description

I built a free, open-source macOS WidgetKit app that shows your Claude Code / Claude Max rate limits at a glance.

If you use Claude Code heavily, you've probably been surprised by rate limits mid-session. I kept losing track of how close I was to hitting the cap, so I made a desktop widget that stays visible while I work.

What it does: - Displays all four limits simultaneously: Session (5h), Weekly, Weekly Sonnet, and Overage - Color-coded: green (normal), orange (80%+ used), red (rate limited) - Shows reset countdowns for each limit - Auto-refreshes every 15 minutes via WidgetKit - Three sizes (small/medium/large) to fit your desktop

Technical details: - Native Swift + WidgetKit, no Electron - OAuth with PKCE for authentication (no API keys needed) - Uses App Group UserDefaults to share data between the main app and widget extension - Built with XcodeGen, notarized and signed with Developer ID

It's completely free, no tracking, no analytics. Just download the DMG and go.

Feedback welcome — this is my first WidgetKit project and I learned a lot about macOS sandboxing and code signing along the way.

Similar Projects