codex-barbar

A Windows tray app that shows your Codex usage and limits at a glance.

English · 中文

The floating ball stays icon-sized and clockwise. Color shows remaining quota (green / gold / red). Speed shows activity: idle, thinking ×2, Fast ×3.

codex-barbar is a Windows 11 x64 tray application for tracking your Codex usage and quota limits. It talks to the official Codex App Server protocol, keeps credentials local, and shows live quota in your tray, taskbar, and a floating ball.

Rendered from the current React/CSS components. Every account name, date, and quota value in the showcase is synthetic demo data.

Visual Tour

Quota color states

• Green: 67–100% remaining
• Yellow: 34–66% remaining
• Red: 0–33% remaining

Activity motion

Color and speed are independent. Color shows remaining quota; clockwise rotation shows activity: Idle 1×, Thinking 2×, Fast 3×.

Resident taskbar status

Star History

Features

• Tray panel with account, quota, reset time, and manual refresh
• Taskbar status overlay (optional, opacity adjustable)
• Floating status ball (optional) with green / yellow / red quota colors
• Clockwise activity animation: Idle 1×, Thinking 2×, Fast 3×
• Auto refresh on a configurable interval (default 5 minutes)
• Shows the real OpenAI account name (not "current cli")
• Weekly quota with reset countdown
• Per-user install, no admin required
• No telemetry; credentials stay local (DPAPI protected)

Quick Start

1. Go to Releases.
2. Download codex-barbar_<version>_x64-setup.exe (recommended) or codex-barbar_<version>_x64-portable.zip.
3. Run the installer (per-user, no admin needed) or extract and launch the portable build.
4. The app starts in the system tray. Click the tray icon to open the usage panel.
5. If it shows Not signed in, run codex login in a terminal, then click Refresh in the panel.
6. Open Settings → General to configure the taskbar status and floating ball. New installs enable Start at login and the floating ball; the taskbar status is optional and off by default.

Requirements

• Windows 11 x64 (23H2 or newer)
• A working Codex installation signed in with codex login

First Run

Your data is stored under %LOCALAPPDATA%\codex-barbar. To remove all accounts and cache, close the app and delete that directory, or use the uninstaller's confirmation prompt.

Settings

• General — start at login, taskbar status, floating ball, opacity, refresh interval, display mode, theme, language
• Accounts — manage signed-in Codex accounts
• Advanced — Codex executable path validation and diagnostics export
• About — version and update check

Data & Privacy

• Reads usage through the official but experimental codex app-server stdio JSONL protocol. experimentalApi stays disabled; private /wham/* calls are removed.
• Managed profiles use an isolated CODEX_HOME, force file credential storage, and protect credentials with Windows DPAPI (Current User only).
• The current CLI profile is read-only. codex-barbar never logs in, logs out, switches, or deletes accounts on your behalf.
• No telemetry. Startup never checks for, downloads, or applies updates; you trigger update checks manually from the UI.

Development

# Rust backend / CLI
cargo test --manifest-path rust/Cargo.toml
cargo clippy --manifest-path rust/Cargo.toml --all-targets -- -D warnings

# Tauri shell crate
cargo test --manifest-path apps/desktop-tauri/src-tauri/Cargo.toml
cargo clippy --manifest-path apps/desktop-tauri/src-tauri/Cargo.toml --all-targets -- -D warnings

# Frontend (use pnpm)
pnpm --dir apps/desktop-tauri install
pnpm --dir apps/desktop-tauri test
pnpm --dir apps/desktop-tauri run tauri:build

See docs/BUILDING.md and docs/ARCHITECTURE.md.

Docs

• PRIVACY.md — what is stored, where, and the threat boundary
• TROUBLESHOOTING.md — error states and recovery steps
• docs/TESTED_CODEX_VERSIONS.md — tested Codex version limits
• CHANGELOG.md — release history

Upstream

codex-barbar is a Windows port of CodexBar. The audited source record and frozen baseline are documented in UPSTREAMS.md.

License

MIT — see LICENSE.