Claude Code Usage Monitor

A lightweight, open-source Windows taskbar widget for monitoring Claude Code usage limits and reset times. It can also display usage for Codex, Google Antigravity, OpenCode Go, and Cursor.

Features

• Displays current usage and time remaining until each limit resets
• Supports Claude Code, Codex, Google Antigravity, OpenCode Go, and Cursor
• Lives in the Windows taskbar with quick controls in the system tray
• Supports multiple monitors and Windows startup
• Includes configurable refresh intervals, providers, languages, and updates
• Provides built-in themes and a visual Theme Studio for custom layouts
• Collects no analytics or telemetry

Requirements

• Windows 10 or Windows 11
• At least one supported provider installed and signed in

Claude Code credentials can be detected from the CLI, Claude desktop app, or WSL. Other providers are optional and can be enabled independently from the dashboard.

Installation

Install the latest release with WinGet:

winget install CodeZeno.ClaudeCodeUsageMonitor

Alternatively, download claude-code-usage-monitor.exe from GitHub Releases.

Usage

Start the monitor:

claude-code-usage-monitor

Open the settings dashboard directly:

claude-code-usage-monitor --dashboard

Use the dashboard to select providers, change the refresh interval, choose a display, enable startup, or customize the widget. In the default theme, left-click a provider tray icon to show or hide the widget and right-click it to open the menu.

Provider setup

Provider	Setup
Claude Code	Sign in with the Claude Code CLI or desktop app. Windows and WSL credentials are detected automatically.
Codex	Install and sign in to the Codex CLI, then enable Codex in Providers.
Google Antigravity	Sign in to Antigravity, then enable it in Providers.
OpenCode Go	Connect an OpenCode Go account, configure the credentials described below, then enable OpenCode in Providers.
Cursor	Sign in to Cursor, then enable it in Providers. The local session is detected automatically.

For OpenCode Go, set OPENCODE_GO_WORKSPACE_ID and OPENCODE_GO_AUTH_COOKIE, or create %APPDATA%\opencode-go\config.json:

{
  "workspaceId": "wrk_01...",
  "authCookie": "your-opencode-auth-cookie"
}

The workspace ID is part of the OpenCode Go workspace URL. The auth cookie comes from an authenticated opencode.ai browser session. Set OPENCODE_GO_CONFIG_FILE to use a different config path.

For Cursor, CURSOR_SESSION_TOKEN can override the automatically detected local session.

Data and privacy

The monitor reads local sign-in credentials for enabled providers and sends usage requests directly to their official services. It has no backend service, collects no telemetry, and does not upload credentials or project files.

Credentials are read without modifying the provider files that contain them. OpenCode Go credentials saved in a JSON configuration file are plain text and should be protected like a browser session cookie.

Troubleshooting

Run diagnostics with:

claude-code-usage-monitor --diagnose

The diagnostic log is written to %TEMP%\claude-code-usage-monitor.log. Application settings are stored in %APPDATA%\ClaudeCodeUsageMonitor\settings.json.

Build from source

Install Rust 1.95 or later, then run:

cargo build --release

The executable will be created at target\release\claude-code-usage-monitor.exe.

License

Licensed under the MIT License.