Claude Usage Tracker

---

Overview

Claude Usage Tracker is a lightweight, native macOS menu bar application that provides real-time monitoring of your Claude AI usage limits. Built entirely with Swift and SwiftUI, it offers a clean, intuitive interface to track your 5-hour session window, weekly usage limits, and Opus-specific consumption.

Key Capabilities

• Multi-Provider Support: Track OpenAI Codex usage alongside Claude — per-profile provider selection, built on a registry so more providers can follow

• Dynamic Island (Beta): A minimal notch HUD showing what Claude Code is doing in real time — current tool, session status, and a pulse when Claude needs your input

• Multi-Profile Support: Manage unlimited Claude accounts with isolated credentials and settings

• Terminal Launchers: Install a claude- command per profile — each opens Claude Code with that profile's own login while plain claude follows the active profile

• Multi-Profile Display: Monitor all profiles simultaneously in the menu bar

• Claude Code Integration: Sync CLI accounts and auto-switch credentials when changing profiles

• Real-Time Monitoring: Track session, weekly, and per-model usage (Fable, Opus, Sonnet, Design), API console usage, and API costs per profile

• Usage History: Interactive charts tracking session, weekly, and billing data over time

• Global Shortcuts: System-wide keyboard shortcuts (no Accessibility permission)

• Headless Mode: Works on headless Macs via Remote Desktop

• Customizable Interface: 5 icon styles + 3 color modes (Multi-Color/Greyscale/Single Color) + per-element statusline colors + remaining/used percentage toggle

• Smart Automation: Auto-start sessions, auto-switch profiles, threshold notifications

• Developer Tools: Terminal statusline integration with model, context, profile display, weekly/extra usage segments, pace markers, per-element colors, and color modes

• Privacy-First: Credentials in the macOS Keychain, local storage, minimal anonymous analytics (version-only heartbeat), no cloud sync

• Native Performance: Lightweight Swift/SwiftUI design for macOS

  Menu bar icon and detailed usage popover

  Live terminal statusline showing directory, branch, model, context, and color-coded usage

---

What's New

• v3.3.0 (2026-08-29): Multi-provider architecture with OpenAI Codex support (#229) — per-profile provider selection on a registry pattern (docs/ADDING_A_PROVIDER.md); per-profile terminal launchers — claude- commands with isolated CLAUDE_CONFIG_DIR logins and automatic usage tracking after one /login; keychain migration finally works on shipped Developer ID builds (#292); popover shows over full-screen apps (#298); Dynamic Island targets the built-in notch (#294); Cloudflare challenges no longer masquerade as expired credentials (#277); macOS 26 multi-profile crash fixes; transient E1000 on profile switch eliminated; obsolete peak-hours indicator removed (#308); Vietnamese localization — 14 languages total. Thanks to 8 community contributors.