mrkeyoor.com_
Fri 25 Sept 17:44 UTC
Dev Toolsevaluationupdated 25 Sept 2026

Claude-Code-Usage-Monitor review

Claude Code Usage Monitor is a Windows 10 and 11 taskbar widget that shows usage limits and reset times for Claude Code, Codex, Antigravity, OpenCode Go, Cursor, and Grok Build. It saves you from opening each provider's usage page while you work.

Verdict

Our Linux sandbox installed 211 packages, then both build and test commands failed at winit's unsupported-platform guard, so this is a Windows product that should be judged through its release binary or a Windows build. On Windows 10 or 11, it is a strong pick for keeping several coding-assistant limits in sight without sending them through a monitor backend. Accept the local credential access, and wait for issue 144's WinGet fix if a brittle upgrade prompt would disrupt your setup.

We ran it

Lab card: what happened when we ran Claude-Code-Usage-MonitorScreenshot of Claude-Code-Usage-Monitor (github.com/CodeZeno/Claude-Code-Usage-Monitor)
Install✓ · 29s211 packages
Build✗ · 81s
Tests✗ · 13sran, no count parsed
Repo167 files~52,202 lines of source · 2.8 MB · 2 CI workflows · tests dir

Answers from our run

Does Claude-Code-Usage-Monitor build from source?

Dependencies installed in 29 seconds (211 packages), and the build failed. We cloned commit 4f8e9cb into a clean Debian container with 3 CPUs and no project-specific setup.

Do Claude-Code-Usage-Monitor's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use Claude-Code-Usage-Monitor?

macOS or Linux desktop users: the README requires Windows 10 or 11, and our Linux build stopped at winit's unsupported-platform check.

What are the alternatives to Claude-Code-Usage-Monitor?

Claude Code Usage Monitor, Token Monitor, ClaudeBar. Our Linux sandbox installed 211 packages, then both build and test commands failed at winit's unsupported-platform guard, so this is a Windows product that should be judged through its release binary or a Windows build.

Setup4/5One WinGet command, but source verification requires Windows
Docs5/5Provider auth, themes, diagnostics, builds, and updater trust are clear
Community4/5529 stars with same-day issue, pull request, and release activity
Maturity3/5Detailed checks and frequent releases, but the project is still young

Who it’s for

Windows developers who use Claude Code or several supported coding assistants each day.
People who want 5-hour, weekly, or billing-period limits visible beside the taskbar clock.
Claude Code and Codex users who switch between multiple local accounts.
Users willing to let a local open-source app read existing CLI or desktop sign-in credentials.

Who it’s NOT for

macOS or Linux desktop users: the README requires Windows 10 or 11, and our Linux build stopped at winit's unsupported-platform check.
Teams seeking a shared usage dashboard or central history: the app has no backend and displays credentials and quota data from the local Windows user.
Anyone unwilling to grant another process access to provider sessions: the monitor reads local sign-in material, and OpenCode Go setup can store a browser session cookie in plain-text JSON.
Users who need updates to be invisible and failure-proof: open issue 144 reports a crash when GitHub announces a release before its WinGet manifest is available.
Operators who need a signed portable-update chain: the updater verifies GitHub's SHA-256 digest and size, but its own documentation says it has no Authenticode or detached-signature check.

Setup reality

Our sandbox installed 211 Rust packages in 29 seconds. The build failed with exit 101 after 81 seconds, and the test command failed with exit 101 after 13 seconds. Both stopped because winit reported that the compilation platform was unsupported. The commit 4f8e9cb checkout had 167 files and about 52,202 source lines.

Normal installation is a WinGet command or one portable .exe. You need Windows 10 or 11 plus at least one supported provider already installed and signed in. Source builders need the pinned Rust 1.95.0 toolchain; release builds statically link the MSVC runtime.

The app reads existing provider credentials and calls their services directly. Claude credentials can come from its CLI, desktop app, or WSL. OpenCode Go needs a workspace ID and session cookie, while Cursor and Grok can use their locally stored sessions. No monitor account or backend service is required.

Six providers share one spot in the Windows taskbar

Claude Code Usage Monitor puts 6 provider readings beside the taskbar instead of making you visit separate account pages. Claude Code, Codex, Google Antigravity, OpenCode Go, Cursor, and Grok Build are supported in the current README. The widget shows consumption and reset time, and you can reverse the display to show allowance remaining. It also starts with Windows, works across multiple monitors, and exposes quick controls through the system tray.

Claude Code and Codex can each track multiple accounts. Different providers do not always expose the same windows: Claude and Codex commonly have short and weekly limits, while Grok reports one pool per billing period. The monitor leaves Grok's short-window row empty rather than inventing a 5-hour value. That restraint matters because the whole point is deciding whether to start another coding session, switch accounts, or wait for a reset.

Convenience requires access to local provider sessions

There is no monitor account or hosted relay. The app reads sign-in credentials already stored by enabled provider tools, then sends usage requests directly to those providers' services. Its README says it collects no analytics or telemetry and does not upload credentials or project files. Claude credentials can come from the CLI, desktop app, or WSL, while Cursor and Grok use local sessions created by their own applications.

OpenCode Go has the sharpest setup edge. It needs a workspace ID plus a browser session cookie supplied through 2 environment variables or a JSON file under %APPDATA%. The README explicitly calls that cookie plain text and says to protect it like a browser session. Optional diagnostics can also record polling errors to %TEMP%; the project tells users to redact credentials, account identifiers, and personal data before sharing the log. Those are fair warnings for an app living beside several developer identities.

What happened when we ran it

We cloned commit 4f8e9cb into an unprivileged Linux sandbox with 3 CPUs and 12 GB of RAM. Installation succeeded in 29 seconds and pulled 211 Rust packages. The release build then failed with exit code 101 after 81 seconds. The log reached winit 0.30.13 before that crate emitted a compile error saying the platform was unsupported. It did not produce an application binary in this environment.

The test step failed with exit code 101 after 13 seconds at the same winit platform check; the supplied summary contained no passing-test count. The checkout itself contained 167 files, about 52,202 source lines, and 2.8 MB of source. We found 2 CI workflows, a tests directory, and no Dockerfile. The result agrees with the README's Windows-only requirement, but it cannot tell us whether commit 4f8e9cb builds or runs correctly on Windows.

WinGet is the easy path; source builds require Windows

The recommended install is winget install CodeZeno.ClaudeCodeUsageMonitor. A portable executable is also attached to GitHub releases, and the release build statically links the Microsoft C runtime. Developers compiling locally need the Rust 1.95.0 toolchain pinned by the repository. The project goes further than unit tests with a documented Hyper-V harness for Windows 10 and 11, including portable launch, taskbar placement, update-helper, WinGet install, and WinGet upgrade scenarios.

Updates have a carefully stated boundary. The portable updater checks an asset's SHA-256 digest, actual size, and HTTPS source, and rejects files larger than 100 MiB. It does not verify an Authenticode signature or a detached publisher signature. WinGet has a separate timing problem: issue 144 reports that version 2.15.14 could offer an update as soon as GitHub published it, then crash because the matching WinGet manifest had not landed. Pull request 145 was open when we checked.

Theme Studio exposes quotas without pretending they are stable

The dashboard covers provider selection, refresh intervals, startup, display choice, and used-versus-remaining direction. Theme Studio can duplicate a built-in theme, edit its layers, preview changes, and save a custom copy. Text and expression bindings expose provider percentages, reset times, labels, and optional account-specific quotas. That is more control than most taskbar meters provide, especially if several accounts must fit into a small strip.

The user guide says optional Claude quotas can change or disappear by account. Custom layouts are expected to check available = 1 before rendering a bar; missing quotas return available = 0 rather than a guessed allowance. Release v2.15.17 also fixed whole-pixel bar segments at fractional display scales, and v2.15.16 added a Direct3D 11 software fallback when OpenGL setup fails. These details suggest that the visual layer receives real engineering attention, not only new provider badges.

Same-day releases show energy and raise upgrade risk

GitHub showed 529 stars and 7 open issues and pull requests when fetched, split into 2 issues and 5 pull requests. The repository was pushed on September 25, 2026, and v2.15.19 was released that day. Version 2.15.18 had appeared less than 2 hours earlier. Recent changes covered Claude session refresh behavior, dependency policy, display scaling, render fallback, and update verification. This is active maintenance, though the release cadence asks users to pay attention to upgrade behavior.

The Windows focus is the reason to choose this project and the reason many readers should pass. A native taskbar widget is calmer than a terminal dashboard if usage limits matter throughout the day, and the no-backend design keeps provider traffic direct. The 211-package source install and Linux compile stop also make the boundary unmistakable. Try the WinGet or portable release on a Windows account you can inspect; use a cross-platform alternative anywhere else.

Alternatives

ProjectWhat it isPick it when
Claude Code Usage MonitorA cross-platform terminal monitor focused on Claude limits, forecasts, and local history.pick this instead when you use Linux or macOS, prefer a terminal view, and mainly care about Claude Code.
Token Monitor gh↗A cross-platform desktop widget with usage history and support for dozens of coding tools.pick this instead when cross-platform support, historical breakdowns, or multi-device sync matter more than a Windows taskbar fit.
ClaudeBarA macOS menu-bar quota monitor for Claude, Codex, Cursor, and other providers.pick this instead when you want the same glanceable idea on macOS 15 or later.

What people are saying

  1. [github-trending] CodeZeno/Claude-Code-Usage-Monitor

Sources

  1. Claude Code Usage Monitor repository and README
  2. Claude Code Usage Monitor user guide
  3. v2.15.19 release
  4. Portable updater verification and trust boundary
  5. WinGet release timing issue
  6. Dependency security policy

More dev tools reviews

pyxel · dust · kubernetes-the-hard-way · wifit3 · badnotes · container · the whole board →