Claude Code usage

ClaudeMeter

macOS menu bar app for tracking Claude.ai plan usage in real-time. Monitor 5-hour session, 7-day weekly, and Sonnet-specific limits with color-coded indicators and smart notifications.

176 stars 29 forksUsage & cost trackers Source

Install

Install
brew install eddmann/tap/claudemeter

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/eddmann/ClaudeMeter.git

From the README

ClaudeMeter

Keep track of your Claude.ai plan usage at a glance.

Features

- Real-time usage monitoring - Track your 5-hour session, 7-day weekly, and Sonnet-specific usage limits
- Menu bar integration - Clean, colour-coded usage indicator that lives in your macOS menu bar
- Multiple icon styles - Choose from 6 icon styles: Battery, Circular, Minimal, Segments, Dual Bar, or Gauge
- Pacing indicator - Flame icon warns when you're using Claude faster than sustainable pace
- Smart notifications - Configurable alerts at warning and critical thresholds (defaults: 75% and 90%)
- Auto-refresh - Automatic usage updates every 1 minute, 5 minutes, or 10 minutes

Screenshots

Menu Bar

The menu bar icon changes colour based on your usage levels:

When using Sonnet models, an additional indicator shows your Sonnet-specific usage:

Notifications

ClaudeMeter sends native macOS notifications when you reach warning or critical thresholds:

Settings

Configure your Claude session, refresh interval, icon style, and notification thresholds:

Setup Wizard

Installation

Homebrew (Recommended)

Manual Download

1. Download the latest release from GitHub Releases
2. Unzip and move ClaudeMeter.app to Applications
3. Double-click to open

The app is signed and notarized by Apple, so it will open without any security warnings.

Usage

First Launch

1. ClaudeMeter appears in your menu bar as a gauge icon
2. The setup wizard will guide you through initial configuration
3. Import from a browser signed in to claude.ai, or paste your session manually
4. The app validates your session and begins monitoring usage

Claude Session Setup

ClaudeMeter can import your existing Claude session from local browser cookies. Sign in to claude.ai in a supported browser, then choose Import from Browser in the…
Read the full README on GitHub

Details

Language
Swift
License
MIT
Last updated
19 May 2026
Topics
anthropicapi-monitoringclaudemacosmacos-appmenubarnotificationsswiftswiftuiusage-tracker

FAQ

What is ClaudeMeter?

macOS menu bar app for tracking Claude.ai plan usage in real-time. Monitor 5-hour session, 7-day weekly, and Sonnet-specific limits with color-coded indicators and smart notifications. It is a usage for Claude Code, from eddmann/ClaudeMeter on GitHub.

How do I install ClaudeMeter?

Run brew install eddmann/tap/claudemeter, then follow the setup in the README.

Is ClaudeMeter popular?

eddmann/ClaudeMeter has 176 GitHub stars and 29 forks. It was last updated on 19 May 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.