Usagebar
Your Claude and Codex limits, surfaced where you actually work.
Install once, let it read your existing CLI auth locally, and keep the 5-hour window plus weekly usage visible from the macOS menu bar.
Homebrew
The shortest path from zero to a live usage indicator.
brew install betoxf/tap/usagebarRolling window
5h live tracking
Weekly cap
7d usage view
Refresh
Every 60 seconds
Local auth
Live preview
The real app interface, not a placeholder mockup.
Quick start
From install to useful in under a minute.
The flow is short because the app is reading what you already have. Install it, open it, and the menu bar becomes the status line for your CLI usage.
01
Install from Homebrew
The fastest path is one command. If you are already using Claude CLI or Codex CLI, there is nothing else to wire up.
brew install betoxf/tap/usagebar02
Launch it once
Open Usagebar and it immediately checks your local auth stores instead of sending credentials through a hosted service.
open -a Usagebar03
Keep the numbers in sight
Claude and Codex usage stays in the menu bar, with quick refresh, launch-at-login, and display controls available from the dropdown.
brew update && brew upgrade --cask usagebarAlt
No Homebrew available
The install script still gives you a clean fallback if you just want the app in Applications and out of the way.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/betoxf/Usagebar/main/install.sh)"Why it feels better
The utility stays tiny, but the payoff is constant.
Zero-config auth pickup
Usagebar reads the same local CLI-managed auth stores you already use, so setup is usually finished as soon as the app opens.
Private by default
Credentials stay on your Mac. No telemetry, no analytics, and no extra account just to inspect usage.
Built for both providers
Show Claude, Codex, or both. Switch intervals, icon visibility, and display modes are all adjustable from the menu.
Light enough to disappear
The app sits in the menu bar, refreshes quietly, and avoids becoming another window or dashboard you need to keep open.
In motion
Usagebar alternating providers inside the menu bar.
Local setup
It works with the auth you already have.
Claude CLI
Reads the Keychain item Claude Code-credentials, with ~/.claude/.credentials.json as a fallback on older setups.
Codex CLI
Reads ~/.codex/auth.json after a normal codex login.
Manual fallback
Claude can still be connected through browser sign-in when the CLI is not part of your workflow.
Common commands
Install
brew install betoxf/tap/usagebarLaunch
open -a UsagebarUpdate
brew update && brew upgrade --cask usagebarPrivacy and behavior
All credentials remain local to the Mac.
No telemetry, no analytics, and no hosted sync layer.
Launch at Login, provider toggles, and display controls live in the menu itself.
Install Usagebar
If you already use Claude CLI or Codex CLI, the menu bar can do the rest.
brew install betoxf/tap/usagebar