eddmann/ClaudeMeter
macOS menu bar app for tracking Claude.ai plan usage in real-time. Monitor 5-hour session, 7-day weekly, and Sonnet-specific limits with color-coded indicators and smart notifications.
✨ Added
- Import Claude sessions from browsers signed in to claude.ai
- Accept pasted Cookie headers containing `sessionKey` during setup
✨ Added
- Add monochrome menu bar icon mode
🐛 Fixed
- Handle null usage reset timestamps after Claude usage windows reset
- Use native small refresh spinner sizing in the popover
- Show precise reset durations for longer usage windows
✨ Added
- Demo mode launcher and updated screenshots
📋 Changed
- Release workflow now extracts version and release notes automatically from CHANGELOG.md
📦 Installation
- 1. Download `ClaudeMeter-1.2.0.zip`
- 2. Unzip and move `ClaudeMeter.app` to Applications
- 3. Double-click to open
- This release is signed and notarized by Apple.
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ Unofficial tool - Not affiliated with Anthropic. Use at your own risk.
📦 Installation
- 1. Download `ClaudeMeter-1.1.2.zip`
- 2. Unzip and move `ClaudeMeter.app` to Applications
- 3. Double-click to open
- This release is signed and notarized by Apple.
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ Unofficial tool - Not affiliated with Anthropic. Use at your own risk.
📦 Installation
- 1. Download `ClaudeMeter-1.1.1.zip`
- 2. Unzip and move `ClaudeMeter.app` to Applications
- 3. Double-click to open
- This release is signed and notarized by Apple.
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ Unofficial tool - Not affiliated with Anthropic. Use at your own risk.
📦 Installation
- 1. Download `ClaudeMeter-1.1.0.zip`
- 2. Unzip and move `ClaudeMeter.app` to Applications
- 3. Double-click to open
- This release is signed and notarized by Apple.
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ Unofficial tool - Not affiliated with Anthropic. Use at your own risk.
📦 Installation
- 1. Download `ClaudeMeter-1.0.7.zip`
- 2. Unzip and move `ClaudeMeter.app` to Applications
- 3. Double-click to open
- This release is signed and notarized by Apple.
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ Unofficial tool - Not affiliated with Anthropic. Use at your own risk.
📦 Installation
- 1. Download `ClaudeMeter-1.0.6.zip`
- 2. Unzip and move `ClaudeMeter.app` to Applications
- 3. Double-click to open
- This release is signed and notarized by Apple.
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ Unofficial tool - Not affiliated with Anthropic. Use at your own risk.
📦 Installation
- 1. Download `ClaudeMeter-1.0.5.zip`
- 2. Unzip the file
- 3. Move `ClaudeMeter.app` to your Applications folder
- 4. Right-click and select "Open" the first time (to bypass Gatekeeper)
- If you see "ClaudeMeter is damaged and can't be opened", run:
- ```bash
- xattr -cr /Applications/ClaudeMeter.app
- ```
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ This is an unofficial tool and is not affiliated with Anthropic PBC. This app may violate Anthropic's Terms of Service. Use at your own risk.
- Unsigned build - Not notarized by Apple (requires right-click → Open or `xattr -cr`)
- Unofficial API usage - May be blocked or restricted at any time
- Session keys stored securely - macOS Keychain (device-local only)
- No telemetry - No data sent to third parties
- To find your Claude session key, check your browser cookies at claude.ai for the `sessionKey` value (starts with `sk-ant-`).
- By downloading and using this software, you accept full responsibility and acknowledge these risks.
📦 Installation
- 1. Download `ClaudeMeter-1.0.4.zip`
- 2. Unzip the file
- 3. Move `ClaudeMeter.app` to your Applications folder
- 4. Right-click and select "Open" the first time (to bypass Gatekeeper)
- If you see "ClaudeMeter is damaged and can't be opened", run:
- ```bash
- xattr -cr /Applications/ClaudeMeter.app
- ```
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Opus-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ This is an unofficial tool and is not affiliated with Anthropic PBC. This app may violate Anthropic's Terms of Service. Use at your own risk.
- Unsigned build - Not notarized by Apple (requires right-click → Open or `xattr -cr`)
- Unofficial API usage - May be blocked or restricted at any time
- Session keys stored securely - macOS Keychain (device-local only)
- No telemetry - No data sent to third parties
- To find your Claude session key, check your browser cookies at claude.ai for the `sessionKey` value (starts with `sk-ant-`).
- By downloading and using this software, you accept full responsibility and acknowledge these risks.
📦 Installation
- 1. Download `ClaudeMeter-1.0.3.zip`
- 2. Unzip the file
- 3. Move `ClaudeMeter.app` to your Applications folder
- 4. Right-click and select "Open" the first time (to bypass Gatekeeper)
- If you see "ClaudeMeter is damaged and can't be opened", run:
- ```bash
- xattr -cr /Applications/ClaudeMeter.app
- ```
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Opus-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ This is an unofficial tool and is not affiliated with Anthropic PBC. This app may violate Anthropic's Terms of Service. Use at your own risk.
- Unsigned build - Not notarized by Apple (requires right-click → Open or `xattr -cr`)
- Unofficial API usage - May be blocked or restricted at any time
- Session keys stored securely - macOS Keychain (device-local only)
- No telemetry - No data sent to third parties
- To find your Claude session key, check your browser cookies at claude.ai for the `sessionKey` value (starts with `sk-ant-`).
- By downloading and using this software, you accept full responsibility and acknowledge these risks.
📦 Installation
- 1. Download `ClaudeMeter-1.0.2.zip`
- 2. Unzip the file
- 3. Move `ClaudeMeter.app` to your Applications folder
- 4. Right-click and select "Open" the first time (to bypass Gatekeeper)
- If you see "ClaudeMeter is damaged and can't be opened", run:
- ```bash
- xattr -cr /Applications/ClaudeMeter.app
- ```
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Opus-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ This is an unofficial tool and is not affiliated with Anthropic PBC. This app may violate Anthropic's Terms of Service. Use at your own risk.
- Unsigned build - Not notarized by Apple (requires right-click → Open or `xattr -cr`)
- Unofficial API usage - May be blocked or restricted at any time
- Session keys stored securely - macOS Keychain (device-local only)
- No telemetry - No data sent to third parties
- To find your Claude session key, check your browser cookies at claude.ai for the `sessionKey` value (starts with `sk-ant-`).
- By downloading and using this software, you accept full responsibility and acknowledge these risks.
📦 Installation
- 1. Download `ClaudeMeter-1.0.1.zip`
- 2. Unzip the file
- 3. Move `ClaudeMeter.app` to your Applications folder
- 4. Right-click and select "Open" the first time (to bypass Gatekeeper)
- If you see "ClaudeMeter is damaged and can't be opened", run:
- ```bash
- xattr -cr /Applications/ClaudeMeter.app
- ```
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Opus-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ This is an unofficial tool and is not affiliated with Anthropic PBC. This app may violate Anthropic's Terms of Service. Use at your own risk.
- Unsigned build - Not notarized by Apple (requires right-click → Open or `xattr -cr`)
- Unofficial API usage - May be blocked or restricted at any time
- Session keys stored securely - macOS Keychain (device-local only)
- No telemetry - No data sent to third parties
- To find your Claude session key, check your browser cookies at claude.ai for the `sessionKey` value (starts with `sk-ant-`).
- By downloading and using this software, you accept full responsibility and acknowledge these risks.
📦 Installation
- 1. Download `ClaudeMeter-1.0.0.zip`
- 2. Unzip the file
- 3. Move `ClaudeMeter.app` to your Applications folder
- 4. Right-click and select "Open" the first time (to bypass Gatekeeper)
- If you see "ClaudeMeter is damaged and can't be opened", run:
- ```bash
- xattr -cr /Applications/ClaudeMeter.app
- ```
✨ Features
- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Opus-specific usage limits
- Menu bar integration - Clean, color-coded usage indicator that lives in your macOS menu bar
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1-10 minutes (customizable)
📦 Requirements
- macOS 14.0 (Sonoma) or later
- Active Claude.ai account with session key
📦 Disclaimer
- ⚠️ This is an unofficial tool and is not affiliated with Anthropic PBC. This app may violate Anthropic's Terms of Service. Use at your own risk.
- Unsigned build - Not notarized by Apple (requires right-click → Open or `xattr -cr`)
- Unofficial API usage - May be blocked or restricted at any time
- Session keys stored securely - macOS Keychain (device-local only)
- No telemetry - No data sent to third parties
- To find your Claude session key, check your browser cookies at claude.ai for the `sessionKey` value (starts with `sk-ant-`).
- By downloading and using this software, you accept full responsibility and acknowledge these risks.
