Latest release

Install usagio

One Homebrew command puts the binary on your PATH and the menu-bar app in your dock — well, in your menu bar.

Recommended

Homebrew

Installs the binary, wires up the menu-bar agent, and auto-launches it on login. Upgrades come through brew upgrade; a running app relaunches into the new binary without you restarting anything.

 # 1 — Tap and install $ brew install MattJackson/tap/claude-usage
# 2 — Set up the menu-bar app + auto-swap daemon (now and every login) $ claude-usage install

All releases on GitHub →

Verify the install

Confirm the binary is on your PATH, the version matches what you expected, and the menu-bar agent is registered with launchd.

 $ claude-usage --version
$ claude-usage status
$ launchctl list | grep claude-usage

Requires

macOS 13 Ventura or later · Apple Silicon or Intel. Uses the macOS Keychain and launchd; no other daemons or runtimes. Windows and Linux are not currently supported.

Build from source Rust 1.88+ · single cargo build

Requires a recent stable Rust toolchain. The MSRV is 1.88. The workspace builds one binary that powers both the menu-bar app and the CLI.

 $ git clone https://github.com/MattJackson/claude-usage.git
$ cd claude-usage
$ cargo build --release
# Binary at target/release/claude-usage — copy anywhere on your PATH $ cp target/release/claude-usage /usr/local/bin/
$ claude-usage install

Contributing? The repo README covers the layout, tests, and the provider-adapter interface for adding new AI coding CLIs.