Skip to content

Repository files navigation

Claude Usage Bar

A menu bar app that displays your Claude usage in real-time.

Features

  • Specifically designed for Claude Pro and Max usage tracking
  • Shows current session usage percentage in the menu bar
  • Displays weekly usage limits (all models and Sonnet-only)
  • Shows extra usage spending and remaining balance
  • Color-coded icon: green (< 80%), orange (80-95%), red (> 95%)
  • Native notifications at 80% and 95% usage thresholds
  • Auto-refresh every 5 minutes (with manual refresh option)
  • Optional auto-start on login

Unlike other usage trackers, this app loads the actual "Claude usage" web page under the hood to get accurate usage data.

Installation

Download the latest release for your platform from the Releases page.

macOS

  1. Download claude-usage-bar_x.x.x_aarch64.dmg (Apple Silicon) or claude-usage-bar_x.x.x_x64.dmg (Intel)
  2. Open the .dmg and drag the app to Applications
  3. On first launch, right-click the app and select "Open" to bypass Gatekeeper

Windows

  1. Download claude-usage-bar_x.x.x_x64-setup.exe
  2. Run the installer

Linux

  1. Download claude-usage-bar_x.x.x_amd64.deb (Debian/Ubuntu) or claude-usage-bar_x.x.x_amd64.AppImage
  2. Install the package or run the AppImage

Building from source

Prerequisites

Build

npm install
npm run tauri build

The built app will be in src-tauri/target/release/bundle/.

How it works

The app opens a hidden browser window to log into claude.ai and scrapes usage data from the settings page. Your credentials are handled by the browser and are never stored or transmitted by the app.

About

Claude Code usage status bar

Resources

Contributing

Stars

116 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages