Win-CodexBar is a Windows system-tray app for keeping AI coding-tool usage visible without opening a dozen dashboards. It ports the spirit of CodexBar to a Tauri + React desktop shell backed by shared Rust provider logic.
|
|
- 49 providers including Codex, Claude, Copilot, OpenRouter, Cursor, Gemini, DeepSeek, MiniMax, Kiro, Antigravity, Groq, and more.
- Tray-first workflow with a compact provider grid, usage cards, refresh action, settings shortcut, and quit control.
- Provider settings for source selection, credentials, cookie import, token accounts, API keys, regions, and tray-display preferences.
- Windows credential protection for app-managed API keys, manual cookies, and token accounts, using user-scoped DPAPI where available.
- Browser cookie import for Chrome, Edge, Brave, and Firefox, kept opt-in per provider.
- Local CLI for scripting usage, cost, config, diagnostics, and loopback integrations.
- Installer + portable builds with WebView2 runtime bootstrap, VC++ runtime bootstrap, and SHA-256 checksum files.
Install with Windows Package Manager:
winget install Finesssee.Win-CodexBarOr download the latest installer/portable build from GitHub Releases.
- Installer:
CodexBar-<version>-Setup.exe - Portable:
CodexBar-<version>-portable.exe - Checksums: each release includes
.sha256files
Winget distribution is approved through microsoft/winget-pkgs. New versions can take a little time to appear because every Winget update is pinned to a specific release URL and installer hash.
- Launch CodexBar from the Start Menu or portable executable.
- Click the tray icon to open the usage panel.
- Open Settings -> Providers.
- Enable the providers you use.
- Add the matching credential type: OAuth/device login, API key, browser cookies, local CLI login, or token account.
For Claude, browser cookies/sessionKey are preferred because they match Claude's settings-page usage. OAuth and CLI stay available as fallbacks. For CLI-based providers such as Codex and Gemini, sign in with the provider CLI first.
v0.32.6 fixes Windows tray startup/layout glitches, reduces provider refresh contention, lazy-loads heavier surfaces after tray startup, and keeps provider ordering stable in the tray and pop-out views.
See the full history in CHANGELOG.md.
Provider matrix
| Provider | Auth | Tracks |
|---|---|---|
| Codex | OAuth / CLI | Session, Weekly, Credits |
| Claude | Cookies / OAuth fallback / CLI fallback | Session (5h), Weekly |
| Cursor | Cookies | Plan, Usage, Billing |
| Factory | Cookies | Usage |
| Gemini | gcloud OAuth | Quota |
| Copilot | GitHub Device Flow / gh CLI / legacy token | Plan usage, Chat |
| Antigravity | Local LSP | Usage, Per-model quotas |
| z.ai | API Token | Quota |
| MiniMax | API / Cookies | Usage, Billing Summary |
| Kiro | Cookies / CLI | Monthly Credits, Overage |
| Vertex AI | gcloud OAuth | Cost |
| Augment | Cookies | Credits |
| OpenCode | Local Config | Usage |
| Kimi | Cookies | 5h Rate, Weekly |
| Kimi K2 | API Key | Credits |
| Amp | Cookies | Usage |
| Warp | Local Config | Usage |
| Ollama | Cookies / API Key | Usage, Cloud Models, Pace windows |
| Azure OpenAI | API Key | Deployment |
| T3 Chat | Cookies / cURL | Base, Overage |
| OpenRouter | API Key | Credits |
| JetBrains AI | Local Config | Usage |
| Alibaba | Cookies | Usage |
| Alibaba Token Plan | Cookies | Token Plan Credits, Reset date |
| NanoGPT | API Key | Credits |
| Infini | API Key | Session, Weekly, Quota |
| Perplexity | Cookies | Credits, Plan |
| Abacus AI | Cookies | Credits |
| Mistral | Cookies | Billing, Usage |
| OpenCode Go | Cookies | Usage, Zen Balance |
| Kilo | API Key / CLI | Usage |
| Codebuff | API Key / Local Config | Credits, Weekly |
| DeepSeek | API Key | Balance, Usage summaries, Cost |
| Windsurf | Local Cache | Daily, Weekly |
| Manus | Cookies | Credits, Refresh Credits |
| Xiaomi MiMo | Cookies | Balance, Token Plan |
| Doubao | API Key | Request Limits |
| Command Code | Cookies | Monthly Credits, Purchased Credits |
| Crof | API Key | Credits, Request Quota |
| StepFun | Oasis Token | 5h, Weekly, Token refresh |
| Venice | API Key | USD / DIEM Balance |
| OpenAI | Admin API / API Key | Usage, Requests, Project-scoped cost, Credit Balance |
| Grok | Cookies / auth.json | Billing |
| ElevenLabs | API Key | Subscription Credits, Voice Slots |
| Deepgram | API Key | Project Usage |
| Groq | API Key | Enterprise Metrics |
| LLM Proxy | API Key | Quota Stats |
# Prerequisites: Node.js + pnpm. Rust and MinGW are installed by the script when needed.
git clone https://github.com/Finesssee/Win-CodexBar.git
cd Win-CodexBar
.\dev.ps1Useful dev flags:
.\dev.ps1 -Release # optimized build
.\dev.ps1 -SkipBuild # relaunch the last buildCLI examples:
codexbar usage -p claude
codexbar usage -p all
codexbar cost -p codexFor local Windows release builds, use the cached release builder:
.\scripts\windows-release-build.ps1 -Ref v0.32.6 -SmokeInstallThe script builds the real Tauri release binary, verifies signed installer dependencies, packages with Inno Setup, writes installer/portable assets, writes SHA-256 sidecars, and can run a silent install/uninstall smoke test.
More release automation notes live in docs/release/ci-cd.md.
- On-device by default: provider data is read from known local paths or provider APIs you configure.
- Opt-in cookies: browser-cookie extraction only runs for providers you enable.
- Protected secrets: API keys, manual cookies, and token accounts use the secure-file layer; Windows uses user-scoped DPAPI where available.
- Safe diagnostics: diagnostics expose provider/source/status metadata only, never raw cookies, API keys, bearer tokens, or OAuth values.
- Verified updates: installer downloads require a GitHub SHA-256 digest and are re-verified immediately before apply.
| Topic | Link |
|---|---|
| Building from source | extra-docs/BUILDING.md |
| WSL setup and auth tips | extra-docs/WSL.md |
| Browser cookie details | extra-docs/COOKIES.md |
- Original macOS app: steipete/CodexBar by Peter Steinberger
- Inspired by ccusage for cost tracking
MIT, same as the original CodexBar.