Verified project record

steipete/CodexBar

A macOS 14+ menu bar application that displays usage limits, countdowns to the next reset window, and spend dashboards for OpenAI Codex and Claude Code. It reuses existing provider sessions for authentication and includes a bundled CLI for scripting and CI use cases.

Project overview

Project type: Workflow
Deployment: Refer to project documentation
License: MIT

Best for

Developers and general users on macOS 14+ who use OpenAI Codex and Claude Code and want to track usage limits without manual logins.

Key capabilities

Displays per-provider usage limits with countdowns to the next reset in the macOS menu bar.
Provides a bundled command-line interface (`codexbar`) for scripts and CI, including local cost usage.
Reuses existing provider sessions like OAuth, device flow, API keys, and browser cookies. No passwords are stored.
Uses on-device parsing by default for provider data.
Surfaces credit balances, Admin API spend dashboards, provider billing summaries, and local cost scans where the source exposes enough detail.
Polls provider status to surface incident badges in the menu and an indicator overlay on the bar icon.
Provides WidgetKit widgets for supported providers.

Limitations and risks

Requires macOS 14+ (Sonoma) for the full desktop application.

Getting started

Installation difficulty is rated as easy. Users can install via Homebrew Cask or direct download without coding, then open Settings to enable the specific providers they use.

Evidence and sources

GitHub project description: Show usage stats for OpenAI Codex and Claude Code, without having to login.
README: Tiny macOS 14+ menu bar app that keeps **AI coding-provider limits visible** and shows when each window resets.
README: Download: <https://github.com/steipete/CodexBar/releases>
README: - Bundled CLI (`codexbar`) for scripts and CI (including `codexbar cost --provider codex`, `claude`, or `both` for local cost usage); macOS and Linux CLI builds available.
README: Arch Linux AUR package: ```bash yay -S codexbar-cli ```

Reviewed at: 2026-07-17T12:40:18Z