A lightweight macOS menu bar application that displays your Claude Pro/Max subscription usage and API credit balance at a glance.
Sign in to like and favorite skills
A lightweight macOS menu bar application that displays your Claude Pro/Max subscription usage and API credit balance at a glance.
If you're a Claude power user, you've probably found yourself:
/statusClaude Usage Tool solves this by putting your usage stats in your menu bar, always one click away.
# Clone the repository git clone https://github.com/kingigilbert/claude-usage-tool.git cd claude-usage-tool # Install dependencies npm install # Run in development mode npm run electron:dev
# Build the application npm run build # Create distributable .dmg npm run electron:build
The built application will be in the
release/The app requires you to log in to two separate services:
| Service | URL | Purpose |
|---|---|---|
| Claude.ai | claude.ai | Subscription usage data (Pro/Max limits) |
| Platform | platform.claude.com | API credit balance |
Click the respective "Login" buttons in the app to authenticate. Your session is preserved between app restarts.
For advanced usage analytics, you can configure an Anthropic Admin API key:
.env.localANTHROPIC_ADMIN_KEY=sk-ant-admin-your-key-here
Note: The
file is gitignored to prevent accidentally committing credentials..env.local
claude-usage-tool/ ├── electron/ # Main process (Electron) │ ├── main.ts # App lifecycle, window management │ ├── scraper.ts # Web scraping for usage data │ ├── adminApi.ts # Admin API client │ └── preload.ts # Secure IPC bridge ├── src/ # Renderer process (React) │ ├── App.tsx # Main application component │ ├── components/ # UI components │ └── types/ # TypeScript definitions ├── assets/ # App icons └── package.json
| Script | Description |
|---|---|
| Start development mode with hot reload |
| Build for production |
| Create distributable macOS app |
| Run ESLint |
| Run the built app |
The app uses Electron's built-in browser windows to:
This approach means:
Your session may have expired. Click the Login button to re-authenticate.
The app runs as a menu bar app only (no dock icon). Look for the Claude icon in your system tray.
Contributions are welcome! Please feel free to submit a Pull Request.
git checkout -b feature/amazing-featuregit commit -m 'Add some amazing feature'git push origin feature/amazing-featureThis project is licensed under the MIT License - see the LICENSE file for details.
/statusNote: This is an unofficial tool and is not affiliated with or endorsed by Anthropic. Claude, Claude Pro, and Claude Max are trademarks of Anthropic.