cc-usage

Claude.ai usage monitor for macOS menubar. Shows your 5-hour and weekly usage limits as text in the menubar.

Installation

# From npm
npm install -g @davidbrianethier/cc-usage

# Or from GitHub
npm install -g github:dbe/cc-usage

Usage

# First run - will prompt for sessionKey
cc-usage

# Re-authenticate
cc-usage --reauth

# Show help
cc-usage --help

Getting Your Session Key

1. Log into claude.ai in your browser
2. Open DevTools: Cmd+Option+I
3. Go to Application tab > Cookies > claude.ai
4. Find sessionKey and copy its value
5. Paste when prompted by cc-usage

Features

• Menubar display: Shows 45%|72% (5-hour | 7-day usage)
• Auto-refresh: Updates every 10 seconds
• Power-aware: Pauses during system sleep
• Auto-start: Launches on login
• Context menu: Click for Reauth/Quit options

Requirements

• macOS 10.15+
• Node.js 18+

License

ISC