Artzainnn/ClaudeUsageBar

Track your Claude.ai usage right from your Mac menu bar

What it solves

ClaudeUsageBar provides a way for macOS users to monitor their Claude.ai usage limits without having to manually check the settings page. It solves the problem of unexpectedly hitting usage caps during a session or over a week.

How it works

The application is a lightweight macOS menu bar app built with SwiftUI and AppKit. It requires the user to provide a session cookie from Claude.ai's internal API endpoints to authenticate and fetch usage data. Once configured, it automatically refreshes usage statistics every five minutes and displays them as a percentage in the menu bar.

Who it’s for

Users of Claude.ai, including those on the Pro plan, who want a persistent, real-time visual indicator of their remaining message limits on macOS.

Highlights

  • Real-time tracking: Monitors both 5-hour session limits and 7-day weekly limits.
  • Color-coded indicators: The menu bar icon changes color (green, yellow, red) based on usage levels.
  • Smart notifications: Sends system alerts when usage reaches 25%, 50%, 75%, and 90% thresholds.
  • Privacy-first: Stores all data locally on the Mac.
  • Quick access: Includes a keyboard shortcut (Cmd+U) to toggle the usage popup.
  • Pro plan support: Specifically tracks weekly Sonnet usage for Pro subscribers.

Related

  • Project
    m1ckc3s/claude-status-bar

    A macOS menu bar app that provides live status indicators for Claude Code, showing whether the AI is working, thinking, or awaiting user permission.

  • Project
    richhickson/claudecodeusage

    Claude Usage is a native macOS menubar app that shows real‑time Claude Code quota usage (session, weekly, monthly) and alerts you when a Claude Code session is waiting for input, letting you jump directly to the terminal tab. It reads your OAuth token from the Keychain, polls Anthropic’s usage endpoint, and uses Claude Code’s hook system for session monitoring.

  • Project
    SlavomirDurej/claude-usage-widget

    A cross-platform desktop widget that tracks Claude.ai usage statistics, limits, and spending in real-time with visual alerts.

  • Project
    AThevon/TokenEater

    A native macOS utility that monitors Claude AI usage limits in real-time via menu bar apps, widgets, and overlays, helping users avoid hitting token limits unexpectedly.

  • Dispatch
    claude-quota: macOS Menu Bar Gauges for Claude Code Usage

    claude-quota is a SwiftBar plugin for macOS that provides real-time visual gauges in the menu bar to track Claude Code quota utilization across multiple accounts.