Claude Usage Tray

A privacy-conscious Windows notification-area indicator for Claude Code subscription usage, packaged as a Codex plugin.

What it shows

• Five-hour remaining usage as a compact square perimeter gauge.
• Five-hour and seven-day details on left click.
• Local reset times and stale-data status.
• Small, standard, and large detail-panel fonts.

Normal usage is green, the warning range is orange, low remaining usage is deep red, and stale or unavailable data is black.

Privacy

The bridge reads only these official Claude Code status-line fields from standard input:

• rate_limits.five_hour.used_percentage
• rate_limits.five_hour.resets_at
• rate_limits.seven_day.used_percentage
• rate_limits.seven_day.resets_at

It does not read OAuth tokens, API keys, prompts, transcripts, or Claude credential files. It makes no network requests and does not retain raw status-line input. Runtime state stays in %LOCALAPPDATA%\ClaudeUsageTray\state.json.

Requirements

• Windows 10 or Windows 11
• .NET Framework 4.8
• Claude Code with a Claude.ai Pro or Max subscription

Install

From the repository root:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\validate.ps1
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\install.ps1

The installer builds from source, safely backs up and merges %USERPROFILE%\.claude\settings.json, and creates a current-user startup entry. No administrator access is required.

Claude Code provides rate-limit data after the first interactive response in a session. Non-interactive claude -p calls do not refresh the status line.

Uninstall

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\uninstall.ps1

The uninstaller removes only configuration and startup entries that still point to this tool. It leaves source files, binaries, settings backups, and runtime state available for recovery.

Repository contents

• .codex-plugin/plugin.json: Codex plugin manifest.
• skills/claude-usage-tray/SKILL.md: Codex operating instructions.
• scripts/: plugin entry-point scripts.
• app/: .NET Framework WinForms source and tests.
• assets/: non-personal visual preview.