ClaudeMeter

A lightweight macOS menu bar app to track your Claude Code usage

Features

  • 🎯 Real-time usage display in menu bar with color indicators (🟢 <70%, 🟡 70-90%, 🔴 >90%)
  • 📊 Session (5h) and Weekly (7d) usage tracking
  • 🔔 Notifications at 80% and 90% usage thresholds
  • 🚀 Launch at login option
  • 🔄 Auto-refresh every 2 minutes
  • 😴 Smart retry after wake from sleep

Download

Download ClaudeMeter v1.0.0

Version 1.0.0 • Released January 22, 2026

Installation

  1. Download ClaudeMeter.zip above
  2. Unzip and drag ClaudeMeter.app to your Applications folder
  3. Open the app (you may need to right-click → Open the first time due to macOS security)

Requirements

  • • macOS 13.0 (Ventura) or later
  • • Claude Code CLI installed and logged in with user:profile scope

Setup

If you see "Token missing required scope" error, re-authenticate:

$ claude /logout
$ claude

Open Source

ClaudeMeter is free and open source. View the source code, report issues, or contribute on GitHub.

View on GitHub