System tray app that shows your real Claude Code & OpenAI Codex usage — session limits, weekly limits, reset times, and API costs — right from the Windows taskbar.
Windows port of steipete/CodexBar for macOS.
- Go to Releases
- Download
CodexBar.exeorCodexBar-Win.zip - Run
CodexBar.exe— it appears in your system tray
git clone https://github.com/babakarto/CodexBar-Win.git
cd CodexBar-Win
pip install -r requirements.txt
python codexbar.pyOr double-click CodexBar.bat — it installs dependencies and launches.
- Windows 10 or 11
- Claude Code CLI installed and logged in (
claudein PATH) - Python 3.10+ (only if running from source)
- Dual provider — Claude Code + OpenAI Codex tabs with smooth animated transitions
- Live usage bars — session and weekly limits with color-coded percentages
- Reset countdowns — know exactly when your limits refresh
- Cost tracking — today's spend and 30-day totals from local logs
- Native popup — customtkinter window with rounded corners, slide-up animation
- Provider branding — Claude orange palette + OpenAI dark/green theme, tray icon switches per tab
- Auto-refresh — updates every 5 minutes
- Zero config — reads everything Claude Code already stores locally
CodexBar tries multiple methods in order, using the first that succeeds:
| Priority | Method | What it does |
|---|---|---|
| 1 | CLI (PTY) | Spawns interactive claude via pseudo-terminal, sends /usage, parses output |
| 2 | OAuth token | Reads ~/.claude/.credentials.json, calls Claude.ai API |
| 3 | Browser cookies | Reads sessionKey from Chrome/Edge/Brave, decrypts with DPAPI + AES-GCM |
| 4 | JSONL logs | Scans ~/.claude/projects/ for conversation logs (always runs for cost data) |
| CodexBar (macOS) | CodexBar-Win (Windows) | |
|---|---|---|
| UI | SwiftUI menu bar popup | customtkinter system tray popup |
| Language | Swift | Python |
| Providers | 16+ (Claude, Cursor, Copilot, Gemini...) | Claude Code + OpenAI Codex |
| Data source | CLI PTY | CLI PTY → OAuth → Cookies → JSONL |
| Install | brew install --cask steipete/tap/codexbar |
Download .exe or pip install |
| Auto-update | Sparkle framework | GitHub Releases |
| Cookie decrypt | macOS Keychain | Windows DPAPI + AES-GCM via ctypes |
| Size | ~5 MB (native) | ~30 MB (bundled Python runtime) |
| License | MIT | MIT |
.\build.ps1
# Output: dist/CodexBar.exe (~30 MB)Requires PyInstaller (pip install pyinstaller). The script handles icon generation and all hidden imports.
| Problem | Fix |
|---|---|
| No usage data shown | Make sure claude is in PATH and you're logged in |
| "winpty not found" | pip install pywinpty |
| Antivirus flags .exe | PyInstaller executables are commonly false-positived. Add an exception or run from source |
| Popup doesn't appear | Check the system tray overflow area (click ^ arrow near clock) |
| CLI shows 0% | Another Claude Code session may be running — CodexBar spawns its own PTY |
Windows port inspired by steipete/CodexBar (MIT) by Peter Steinberger — the original macOS menu bar app.
MIT