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.