naufalrafifr01

🌟 claudecodeusage - Easy Access to Your Claude Usage Limits

📥 Overview

Claude Usage is a lightweight macOS menubar app that helps you check your Claude Code usage limits at a glance. Monitor your usage easily without extra distractions.

Built by @richhickson.

🚀 Features

• 🔄 Auto-refresh: The app updates your usage information every 2 minutes.
• 🚦 Color-coded status: Quickly know your limits with a color system:
  • Green (OK)
  • Yellow (>70%)
  • Red (>90%)
• ⏱️ Time until reset: View both session and weekly limits with a countdown.
• 📊 Session & Weekly limits: Your usage limits displayed side by side for clarity.
• 🪶 Lightweight: Built with native Swift, using minimal resources.

📥 Download & Install

1. Visit the Releases page.
2. Download ClaudeUsage.zip.
3. Unzip the file and drag ClaudeUsage.app into your Applications folder.
4. Open the app. You may need to right-click and select “Open” the first time.

🖥️ Requirements

• Operating System: macOS 13.0 (Ventura) or later.
• Network Connection: Internet access is required for real-time updates.

🛠️ How to Use the App

1. Open the App

Once installed, find ClaudeUsage in your Applications folder and double-click to launch it. The app will appear in your menubar.

2. View Your Usage

The app displays your current session and weekly limits right at the top. It refreshes every 2 minutes to keep you updated.

3. Understand the Color Codes

• Green: Your usage is within the safe limit.
• Yellow: You are nearing your limit. It’s time to be cautious.
• Red: You have exceeded 90% of your limit. Consider reducing your usage.

4. Reset Timer

Check the timer for both session and weekly limits. This feature helps you track when limits reset according to Claude’s schedule.

⚙️ Troubleshooting

If you encounter issues:

• Ensure you are running macOS 13.0 or later.
• Check your network connection for auto-refresh.
• Restart the app if it doesn’t respond.

🔧 Build from Source (Optional)

If you want to explore making changes or running your own version, you can build from source. Follow these steps:

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/claudecodeusage.git
   

2. Change to the application directory:

   cd claude-usage
   

3. Open the project in Xcode:

   open ClaudeUsage.xcodeproj
   

4. Build the project by pressing ⌘B and run it with ⌘R.

📜 License

This project is licensed under the MIT License.

📬 Support

If you have questions or feedback, feel free to open an issue in the repository. Your input helps improve the app.

For direct support, you can reach out through the project’s main page or create an issue on GitHub.