Skip to content

README.md

Latest commit

 

History

History
executable file
·
133 lines (101 loc) · 5.38 KB

README.md

File metadata and controls

executable file
·
133 lines (101 loc) · 5.38 KB

Win-CodexBar

简体中文说明

The Windows port of CodexBar — a system tray app that keeps your AI coding-tool usage limits visible at a glance.

Built with Tauri + React on a shared Rust backend. The original CodexBar is a macOS Swift app by Peter Steinberger.

Tray panel showing provider grid and Codex usage    Settings — Providers tab

Features

  • 28 AI providers — Codex, Claude, Cursor, Factory, Gemini, Copilot, Antigravity, z.ai, MiniMax, Kiro, Vertex AI, Augment, OpenCode, Kimi, Kimi K2, Amp, Warp, Ollama, OpenRouter, Synthetic, JetBrains AI, Alibaba, NanoGPT, Infini, Perplexity, Abacus AI, OpenCode Go, Kilo
  • System tray icon — dynamic two-bar meter showing session + weekly usage
  • Browser cookie import — Chrome, Edge, Brave, Firefox, with browser access kept opt-in
  • Per-provider credentials — API keys, cookies, and OAuth all managed from the provider detail pane
  • Credential hardening — local secret-bearing stores are protected with Windows DPAPI on save
  • CLI — codexbar usage and codexbar cost for scripting and CI
  • WSL support — CLI works out of the box; desktop shell via WSLg

Quick Start

# Prerequisites: Node.js — Rust and MinGW are installed automatically
git clone https://github.com/Finesssee/Win-CodexBar.git
cd Win-CodexBar
.\dev.ps1

The script installs Rust/MinGW if needed, builds the Tauri desktop shell, and launches the app.

.\dev.ps1 -Release          # optimised build
.\dev.ps1 -SkipBuild        # relaunch last build

Download

Install with Windows Package Manager:

winget install Finesssee.Win-CodexBar

Winget distribution is approved through microsoft/winget-pkgs. New releases may take a little time to appear in Winget after the GitHub release is published because each version is pinned to its own installer URL and SHA-256 hash.

You can also grab the latest build from GitHub Releases.

  • Installer: CodexBar-<version>-Setup.exe
  • Portable: CodexBar-<version>-portable.zip
  • Checksums: each release includes .sha256 files for manual verification

First Run

  1. Launch CodexBar — it sits in the system tray
  2. Click the tray icon to open the usage panel
  3. Open Settings → Providers, enable the services you use
  4. For cookie-based providers, click the provider and use Browser Cookies → Import
  5. For CLI-based providers (codex, claude, gemini), make sure you're logged in

CLI

codexbar usage -p claude          # single provider
codexbar usage -p all             # all enabled providers
codexbar cost  -p codex           # local cost from JSONL logs

Providers

Provider Auth Tracks
Codex OAuth / CLI Session, Weekly, Credits
Claude OAuth / Cookies / CLI Session (5h), Weekly
Cursor Cookies Plan, Usage, Billing
Factory Cookies Usage
Gemini gcloud OAuth Quota
Copilot GitHub Device Flow Usage
Antigravity Cookies / LSP Usage
z.ai API Token Quota
MiniMax API / Cookies Usage
Kiro Cookies / CLI Monthly Credits
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 Usage
OpenRouter API Key Credits
JetBrains AI Local Config Usage
Alibaba Cookies Usage
NanoGPT API Key Credits
Infini API Key Session, Weekly, Quota
Perplexity Cookies Credits, Plan
Abacus AI Cookies Credits
OpenCode Go Cookies Usage
Kilo API Key / CLI Usage

Privacy

  • On-device only — no data sent anywhere except provider APIs
  • No disk scanning — only reads known config paths and browser cookies
  • Opt-in cookies — extraction only runs for providers you enable
  • Protected credential stores — app-managed API keys, manual cookies, and token accounts are written through the secure-file layer; on Windows this uses user-scoped DPAPI where available
  • Safe diagnostics — diagnostic snapshots expose provider/source/status metadata only, never raw cookies, API keys, bearer tokens, or OAuth values
  • Verified updates — automatic installer downloads require a GitHub SHA-256 digest and the installer is re-verified immediately before apply

More Docs

Topic Link
Building from source extra-docs/BUILDING.md
WSL setup & auth tips extra-docs/WSL.md
Browser cookie details extra-docs/COOKIES.md

Credits

License

MIT — same as the original CodexBar.

For the macOS version, visit steipete/CodexBar.