Claude Code usage... Live! Meet Clive. :)
A macOS menu bar app that displays your Claude Code usage statistics at a glance.
- Real-time usage tracking - Monitor your Claude Code session and weekly usage limits
- Multiple display modes:
- Text: Shows percentages directly (e.g.,
CC: 45% (32% weekly)) - Pie Charts: Visual representation with two pie charts
- Bar Charts: Stacked horizontal bars
- Text: Shows percentages directly (e.g.,
- Color-coded indicators - Green (<70%), Orange (70-89%), Red (90%+)
- Configurable refresh intervals - From 1 minute to 30 minutes
- Session reset times - See when your session usage will reset
Honestly, I vibe coded this thing in the space of an hour. It works for me, hopefully it works for you too. I just wanted to be able to keep an eye on my token budget without having to manually go looking for it.
- macOS 14.0 or later
- Claude Code CLI installed at
/opt/homebrew/bin/claude
Just extrat the app and drag & drop to your Applications folder.
brew install https://raw.githubusercontent.com/StuartCameronCode/clive/main/HomebrewFormula/clive.rbAfter installation, you can open Clive with:
open $(brew --prefix)/Clive.appOr create a symlink to Applications:
ln -s $(brew --prefix)/Clive.app /Applications/Clive.appTo upgrade to a newer version:
brew upgrade cliveNote: Once you create the symlink, it automatically points to the latest version after upgrades—no need to recreate it.
Once running, Clive appears in your menu bar showing your Claude Code usage. Click the icon to see:
- Session usage - Current session percentage and reset time
- Weekly usage - Current week's percentage
Access Settings (⌘,) to configure:
- Display mode (Text, Pie Charts, or Bar Charts)
- Refresh interval (1-30 minutes)
Clive periodically runs claude /usage to fetch your current usage statistics and displays them in the menu bar. The app parses the output to extract session and weekly usage percentages.
No hacking of session tokens etc required :).
MIT License - see LICENSE for details.