Percent

A macOS menu bar app that displays your Claude Code usage percentage and reset times.

Features

• Shows 5-hour window usage percentage in the menu bar
• Displays countdown and reset times for both 5-hour and 7-day windows
• Color-coded progress bars (green/orange/red based on usage)
• Auto-refreshes every 5 minutes
• Optional: Show reset time next to percentage in menu bar

Requirements

• macOS 13.0 or later
• Claude Code CLI installed and logged in
• Xcode 15+ (to build)

Installation

1. Clone this repository
2. Open Percent.xcodeproj in Xcode
3. Select your development team in Signing & Capabilities
4. Build and run (Cmd+R)

How It Works

The app reads your Claude Code OAuth credentials from the macOS Keychain and fetches usage data from Anthropic's API. No credentials are stored in the app itself.

Usage Windows Explained

• 5-Hour Window: Rolling limit that resets 5 hours after your first message. Prevents burst usage.
• 7-Day Window: Weekly allocation that resets once per week. This is the main limit for sustained usage.

License

MIT