https://github.com/decryptu/claude-meter
A native macOS menu bar application that displays your Claude AI usage statistics in real-time with automatic credential detection.
https://github.com/decryptu/claude-meter
claude claude-ai claude-api claude-code claude-desktop macos menubar
Last synced: 2 months ago
JSON representation
A native macOS menu bar application that displays your Claude AI usage statistics in real-time with automatic credential detection.
- Host: GitHub
- URL: https://github.com/decryptu/claude-meter
- Owner: Decryptu
- License: mit
- Created: 2025-11-04T16:17:22.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-11-04T19:11:21.000Z (2 months ago)
- Last Synced: 2025-11-04T19:16:43.799Z (2 months ago)
- Topics: claude, claude-ai, claude-api, claude-code, claude-desktop, macos, menubar
- Language: Swift
- Homepage: https://github.com/Decryptu/claude-meter/releases
- Size: 43.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ClaudeMeter
A native macOS menu bar app that shows your Claude app usage in real-time — works with the Claude desktop app or claude.ai in your browser.
> ✅ **No API keys required** — ClaudeMeter reads usage from your Claude account session (desktop or browser).
> ❌ **This is not a tool for the Claude API**.
## Features
- **Automatic Setup** — Detects your Claude Desktop or browser session
- **Menu Bar Integration** — Ring indicator
- **Real-Time Updates** — Refreshes every 60 seconds
- **Launch at Login** — Toggle from the menu
- **Modern UI** — SwiftUI, native macOS 13-26 interface
- **Built-in Logs** — Debug directly from the menu
## Quick Start
```bash
git clone https://github.com/decryptu/claude-meter.git
cd claude-meter
./run.sh
```
The app will auto-detect your Claude Desktop or browser session and begin monitoring.
## Prerequisites
- macOS 13+
- Swift 5.9+ (Xcode or CLI tools)
- A logged-in Claude account on the desktop app or claude.ai in a browser
No API key needed.
## Installation Options
### Option 1 — Quick Run
```bash
./run.sh
```
### Option 2 — Manual Build
```bash
swift build -c release
./.build/release/ClaudeMeter
```
### Option 3 — Install to Applications
```bash
./Scripts/install.sh
```
## Configuration
### Automatic (Default)
On first launch, ClaudeMeter shows a welcome dialog offering two options:
**Try Auto-Detection** — Automatically detects your Claude session from:
- Claude Desktop cookies
- Brave Browser cookies
- Chrome cookies
You'll be asked to grant Keychain access to decrypt cookies securely.
**Configure Manually** — Skip auto-detection and enter credentials yourself.
If auto-detection succeeds, monitoring starts automatically.
### Manual Setup
If you choose manual setup or auto-detection fails:
1. Click the menu bar icon
2. Open "Settings"
3. Enter credentials manually
To manually retrieve session details:
1. Visit while logged in
2. Open Developer Tools → Network
3. Refresh, inspect the usage request
4. Copy:
- Organization ID from the URL
- Session Key from the Cookie header
## Usage
### Dropdown Menu Includes
- Current usage + reset timer
- Refresh (Cmd+R)
- Launch at Login
- Settings (Cmd+,)
- Logs
- Quit (Cmd+Q)
## Troubleshooting
- **"Setup Required"** → Make sure Claude Desktop or claude.ai is logged in
- **No data** → Session may have expired
- **Permissions** → Grant Full Disk Access if needed (for cookie access)
Logs are stored in:
```bash
~/.config/claude-meter/logs/
```
## Building for Distribution
```bash
./Scripts/build-app.sh 1.0.0
```
Unsigned .app will be placed in `dist/`.
Prepare a GitHub release:
```bash
./Scripts/prepare-release.sh 1.0.0
```
## Development
```bash
swift build
swift build -c release
```
Key files:
- `CredentialExtractor.swift`
- `MenuBarManager.swift`
- `SettingsView.swift`
- `Logger.swift`
## Security
- Everything stays on-device
- Only communicates with claude.ai
- No API keys, no telemetry, no tracking
- Open source
## License
MIT — see [LICENSE](LICENSE)
---
Unofficial utility — not affiliated with Anthropic or Claude.
Made with ❤️ for the Claude community.