Your AI usage limits, at a glance in the Windows taskbar.
UsageHub is a Windows taskbar monitor for usage and reset times across Claude Code, Codex, and other AI tools. Keep the bar in view; open the dashboard only when you need settings or account management.
Download the latest UsageHub release · Quick start · Accounts and cleanup · User guide
Windows 10 or 11 and a supported provider with a signed-in account. Provider-specific setup is below.
Download usagehub.exe from the latest release and place it in a user-writable folder. UsageHub can run alongside the upstream monitor with separate settings and application identity. For source builds, see Windows build setup.
In PowerShell, from the folder containing the executable:
.\usagehub.exeOpen the settings dashboard from the tray menu, or run:
.\usagehub.exe --dashboardSign in through your provider's own app or CLI, then enable the provider under Settings → Providers. Choose used or remaining allowance under Settings → Display → Usage direction. See the user guide for display options and Theme Studio; theme authors can use .display bindings such as {claude.session.display:usage_line} to follow the selected direction.
- Shows provider-reported usage and reset times in a customizable taskbar bar, with themes, tray controls, and optional Windows startup.
- Manages Claude Code and Codex accounts, including pinned account rows and an overflow chooser.
- Keeps the bar resident and opens the separate GPU-accelerated dashboard on demand. Hardware Direct3D 11 is preferred; software WARP and OpenGL initialization fallbacks are available. See dashboard rendering.
- Uses provider usage responses, not model prompts, CLI probes, inferred allowances, or manually entered reset dates. Missing values remain unknown; failed or stale refreshes are marked rather than presented as current.
| Provider | Sign-in or setup |
|---|---|
| Claude Code | Sign in with the Claude Code CLI or Claude desktop app. Windows and WSL stored logins are supported. |
| Codex | Install and sign in to the Codex CLI. |
| Google Antigravity | Sign in to Antigravity. |
| OpenCode Go | Configure a workspace ID and session cookie as described below. |
| Cursor | Sign in to Cursor; the local session is detected automatically. |
| Grok Build | Sign in through the Grok CLI; an API key alone is not enough. |
| GitHub Copilot | Sign in with the Copilot CLI (copilot, then /login) or GitHub CLI (gh auth login). |
Enable the providers you want under Settings → Providers. For OpenCode Go, set OPENCODE_GO_WORKSPACE_ID and OPENCODE_GO_AUTH_COOKIE, or put workspaceId and authCookie in %APPDATA%\opencode-go\config.json. The workspace ID is in https://opencode.ai/console/<workspaceId>/go; the cookie is __Host-console_session from your signed-in opencode.ai session, including its name. Treat it as a password. OPENCODE_GO_CONFIG_FILE can select another config path.
Open Settings → Accounts, choose Claude Code or Codex, enter a name and select Add account. Sign in using the official app or CLI. Managed Claude Desktop accounts have isolated user-data directories; additional Codex profiles are CLI-only, not isolated Codex Desktop copies. A newly added profile starts signed out: the bar marks it with ! until you sign in. For a Codex profile use Sign in through CLI on its card (it opens a console with that profile's CODEX_HOME and runs the official codex login) or run usagehub --manage signin --provider codex --id ID. If omp already stores a ChatGPT sign-in for that account, Import sign-in from omp reuses it without another authorization (--from-omp, optionally --email), and --list-omp shows what is available. Only the skills library is deliberately shared among managed accounts; credentials, config, and history are not shared through it.
To clean an account, select Cleanup... on its card. The window explains four separate actions:
| Action | What it does |
|---|---|
| Sign out, keep chats | Removes identified local sign-in credentials. Chats, settings and identifiers inside that history stay; other sessions may remain. |
| Full reset | Clears owned local sign-in data, history and settings, but keeps the UsageHub profile so the official app can sign in again. |
| Delete profile | Managed profiles only: the same local cleanup, then the profile leaves UsageHub and the bar. |
| Cached files | Regenerable caches only, no backup. |
Preview lists exact targets before anything changes, and Apply needs the typed stable account ID. Default uses the official app's shared local data, so it is never removable: its full reset requires an explicit opt-in. Destructive actions normally create an encrypted seven-day undo snapshot; skipping it is a separate Advanced acknowledgement. Cleanup is limited to proven owned data: it is not forensic erasure, a browser-wide wipe, or removal of vendor telemetry. See migration and recovery for account adoption, shared skills, and rollback.
UsageHub also discovers accounts it does not know about yet: every few hours (default 6 h, configurable in Settings) it scans Claude Desktop data folders, the Claude CLI home, CLAUDE_CONFIG_DIR, an explicit CODEX_HOME, and ChatGPT sign-ins already stored by omp. A new source is added once; a profile created this way leaves the list only after three scans without its source, and discovery never deletes account data. Run Scan for accounts from the taskbar account menu, Scan for accounts now in Settings → Accounts, or usagehub --manage discover [--apply].
UsageHub reads local credentials for enabled providers and sends authenticated usage requests directly to their services. It has no hosted backend or analytics of its own. Settings are stored in %APPDATA%\UsageHub; encrypted undo snapshots are stored in %LOCALAPPDATA%\UsageHub\backups. Provider access can change, and use of their endpoints is not a vendor permission or guarantee against account restrictions.
OpenCode Go cookies stored in a JSON config are plain text. Protect them and redact credentials and personal data before sharing logs. Report suspected vulnerabilities privately using SECURITY.md.
The portable in-app updater checks this fork's latest stable release and requires confirmation before installation. It verifies the usagehub.exe asset's size and SHA-256 against GitHub release metadata; this is not a publisher signature. UsageHub has no WinGet package. See updater verification for its trust boundary.
Check the tray icon or account status for refresh errors, then sign in again through the affected provider's app or CLI. An unreported quota displays --; stale or failed refreshes show !. Dashboard Diagnostics can record polling errors. Review and redact logs before sharing them.
See Windows build setup for the pinned Rust and LLVM toolchain, prerequisites, and commands. The changelog records version history.
For project context and operational details, see docs/HANDOFF.md, migration and rollback, and dashboard rendering.
See CONTRIBUTING.md and the Code of Conduct. For security issues, use the private reporting instructions in SECURITY.md.
MIT License. UsageHub is a fork of Claude Code Usage Monitor, Copyright (C) 2026 Code Zeno Pty Ltd. The account manager also adapts multi-account work by Leonxlnx; attribution is preserved in LICENSE. This fork is published at rostikowb/UsageHub, not the upstream repository.