Claude Usage A lightweight macOS menubar app that displays your Claude Code usage limits at a glance. Built by @richhickson Features ๐ Auto-refresh every 2 minutes every 2 minutes ๐ฆ Color-coded status - Green (OK), Yellow (>70%), Red (>90%) - Green (OK), Yellow (>70%), Red (>90%) โฑ๏ธ Time until reset for both session and weekly limits for both session and weekly limits ๐ Session & Weekly limits displayed together displayed together ๐ชถ Lightweight - Native Swift, minimal resources Installation Download Go to Releases Download ClaudeUsage.zip Unzip and drag ClaudeUsage.app to your Applications folder Open the app (you may need to right-click โ Open the first time) Build from Source git clone https://github.com/YOUR_USERNAME/claude-usage.git cd claude-usage open ClaudeUsage.xcodeproj Then build with โB and run with โR. Requirements macOS 13.0 (Ventura) or later Claude Code CLI installed and logged in Setup Install Claude Code if you haven't already: npm install -g @anthropic-ai/claude-code Log in to Claude Code: claude Launch Claude Usage - it will read your credentials from Keychain automatically How It Works Claude Usage reads your Claude Code OAuth credentials from macOS Keychain and queries the usage API endpoint at api.anthropic.com/api/oauth/usage . Note: This uses an undocumented API that could change at any time. The app will gracefully handle API changes but may stop working if Anthropic modifies the endpoint. Privacy Your credentials never leave your machine No analytics or telemetry No data sent anywhere except Anthropic's API Open source - verify the code yourself Screenshots Normal Warning Critical ๐ข 30% ๐ก 75% ๐ด 95% Troubleshooting "Not logged in to Claude Code" Run claude in Terminal and complete the login flow. App doesn't appear in menubar Check if the app is running in Activity Monitor. Try quitting and reopening. Usage shows wrong values Click the refresh button (โป) in the dropdown. If still wrong, your Claude Code session may have expired - run claude ...
First seen: 2026-01-08 20:49
Last seen: 2026-01-09 12:51