← Reddit

I built a free macOS menu bar app that shows your real-time Claude usage — session %, weekly limit, spend, and routine runs (no API key needed)

Reddit · EvolvinAI29 · April 29, 2026
A developer built a free macOS menu bar application that displays Claude usage statistics in real-time, including session percentage, weekly limits, spending, and routine runs without requiring an API key. The tool reads the Claude desktop app's encrypted SQLite database, decrypts the session key via macOS Keychain, and fetches usage data from Claude's internal API every two minutes, with a color-coded menu bar icon and notifications at usage milestones. The application includes a local web dashboard with charts and CSV export capabilities and is available on GitHub for setup via three simple commands.

Detailed Analysis

A developer identified as "divaaker" has released a free, open-source macOS menu bar application called claude-usage-tracker that provides real-time visibility into Claude AI consumption metrics that Anthropic does not surface natively within its desktop client. The app displays session usage percentage via a color-coded menu bar icon, a countdown to session reset, weekly usage percentage, monthly spend against a configurable budget, routine run counts (tracked against a five-run limit), and a design limit percentage. A local web dashboard accessible at localhost:8080 supplements the menu bar view with charted historical data and CSV export functionality. The application auto-syncs every two minutes and triggers user notifications at the 25%, 50%, and 75% session usage thresholds, giving users advance warning before hitting hard limits.

The technical mechanism behind the app is notably sophisticated for a community-built utility. Rather than requiring users to generate or manage API keys separately, the application reads the Claude desktop app's encrypted SQLite cookie database, decrypts the session token through the macOS Keychain, and then queries Claude's internal usage API directly. All processing remains entirely local — no data is transmitted to external servers — making it both privacy-preserving and self-contained. The macOS-exclusivity is a direct consequence of this architecture: the tool relies on the platform-specific Keychain credential store and the `rumps` menu bar framework, neither of which has a cross-platform equivalent. Installation is reduced to three shell commands, lowering the barrier for non-technical Claude users who nonetheless want usage awareness.

The release arrives in the context of a broader, rapidly growing ecosystem of third-party Claude usage monitoring tools, reflecting a genuine gap in Anthropic's first-party tooling. Comparable projects include Usagebar, which focuses on Claude Code's five-hour and weekly limits; ClaudeMeter, which offers Homebrew installation and JSON export; and ClaudeBar, which extends multi-AI monitoring to Claude, Codex, and Gemini simultaneously. The proliferation of these independent utilities signals strong user demand for usage transparency that Anthropic has not yet addressed in its native clients — a demand that intensifies as Claude's tiered subscription plans impose session, weekly, and monthly consumption limits that users must actively manage to avoid disruption to their workflows.

This pattern of community-built observability tooling is itself a broader trend across the AI-as-a-service landscape, where usage limits are structurally central to pricing models but dashboards and real-time feedback mechanisms are often minimal or absent. Developers who rely heavily on Claude — particularly through the Claude Code CLI for software development tasks — have an outsized need for granular consumption data, since exceeding session limits mid-task can halt work abruptly. The fact that multiple independent developers have converged on similar solutions within a compressed timeframe suggests a market signal: either Anthropic will eventually build native usage visibility into its clients, or the most polished third-party solution will consolidate the user base currently fragmented across these competing utilities.

The open-source and forkable nature of claude-usage-tracker, along with the developer's explicit invitation for contributions such as login-launch automation and notification center widgets, positions it as a community infrastructure project rather than a one-off personal tool. Its direct reading of Anthropic's internal usage API does introduce a degree of fragility — any changes Anthropic makes to that API's structure or authentication mechanism could silently break the integration — but this is a common tradeoff in tools that depend on undocumented or internal endpoints. For now, the app represents a pragmatic response to a concrete usability limitation in Anthropic's product, and its clean local-only architecture makes it among the more trustworthy options in an increasingly crowded field of similar tools.

Read original article →