Tiny macOS 15+ menu bar app that keeps your Codex and Claude Code limits visible (5‑hour/session + weekly windows) and when each window resets. One status item per provider; enable either or both from Settings. No Dock icon, minimal UI, dynamic bar icons in the menu bar.

• Homebrew (UI app; Sparkle disabled): brew install --cask steipete/tap/codexbar (update via brew upgrade --cask steipete/tap/codexbar)
• Or download the ready-to-run zip from GitHub Releases: https://github.com/steipete/CodexBar/releases

Login story

• Codex — Prefers the local codex app-server RPC for 5h/weekly limits + credits. Falls back to a PTY scrape of codex /status (auth/email/plan from the RPC or ~/.codex/auth.json). All parsing stays on-device; no browser required.
• Codex (optional OpenAI web) — Settings → General → "Access OpenAI via web" reuses an existing signed-in chatgpt.com session (Safari → Chrome cookie import) to show Code review remaining, Usage breakdown, and Credits usage history (when available). No passwords stored; may require granting Full Disk Access for Safari cookie import.
• Claude Code — Reads session + weekly + Sonnet-only weekly usage from the Claude CLI by running /usage + /status in a local PTY (no tmux). Shows email/org/login method directly from the CLI output. No browser or network calls beyond the CLI itself.
• Cursor — Fetches plan usage and on-demand usage from cursor.com API using browser session cookies (Safari → Chrome). Shows included plan percentage, on-demand spend, and billing cycle reset time. Supports Pro, Enterprise, and other membership types. No CLI required; just stay signed in to cursor.com in your browser.
• Provider detection — On first launch we detect installed CLIs and enable Codex by default (Claude turns on when the claude binary is present). You can toggle either provider in Settings → General or rerun detection after installing a CLI.
• Privacy note — Wondering if CodexBar scans your disk? It doesn't; see the discussion and audit notes in issue #12.

Icon bar mapping (grayscale)

• Top bar: 5‑hour window when available; if weekly is exhausted, the top becomes a thick credits bar (scaled to a 1k cap) to show paid credits left.
• Bottom bar: weekly window (a thin line). If weekly is zero you’ll see it empty under the credits bar; when weekly has budget it stays filled proportionally.
• Errors/unknowns dim the icon; no text is drawn in the icon to stay legible. Codex icons keep the eyelid blink; when Claude is enabled the template switches to the Claude notch/leg variant while keeping the same bar mapping.

• Dual providers: Codex status item (5h/weekly + credits) and Claude Code status item (session/weekly + Sonnet-only weekly limit) can be shown together; Codex defaults on, Claude turns on when the CLI is present. Both sections show last-updated time and surface errors inline.
• Codex path: prefers the codex app-server RPC (run with -s read-only -a untrusted) for rate limits and credits; falls back to a PTY scrape of codex /status, keeping cached credits when RPC is unavailable.
• Codex optional: “Access OpenAI via web” adds Code review remaining + Usage breakdown + Credits usage history (dashboard scrape) by reusing existing browser cookies; no passwords stored.
• Claude path: runs claude /usage and /status in a local PTY (no tmux) to parse session/week/Sonnet percentages, reset strings, and account email/org/login method; debug view can copy the latest raw scrape.
• Account line keeps data siloed: Codex plan/email come from RPC/auth.json, Claude plan/email come only from the Claude CLI output; we never mix provider identity fields.
• Auto-update via Sparkle (auto-check + auto-download; menu shows “Update ready, restart now?” once downloaded). Feed defaults to the GitHub Releases appcast (replace SUPublicEDKey with your Ed25519 public key).

swift build -c release          # or debug for development
./Scripts/package_app.sh        # builds CodexBar.app in-place
open CodexBar.app

Requirements:

• macOS 15+.
• Codex: Codex CLI ≥ 0.55.0 installed and logged in (codex --version) to show the Codex row + credits. If your account hasn’t reported usage yet, the menu will show “No usage yet.”
• Claude: Claude Code CLI installed (claude --version) and logged in via claude login to show the Claude row. Run at least one /usage so session/week numbers exist.
• OpenAI web (optional): stay signed in to chatgpt.com in Safari or Chrome. Safari cookie import may require Full Disk Access (System Settings → Privacy & Security → Full Disk Access → enable CodexBar).

Menu → “Refresh every …” presets: Manual, 1 min, 2 min, 5 min (default), 15 min. Manual still allows “Refresh now.”

export APP_STORE_CONNECT_API_KEY_P8="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
export APP_STORE_CONNECT_KEY_ID="ABC123XYZ"
export APP_STORE_CONNECT_ISSUER_ID="00000000-0000-0000-0000-000000000000"
./Scripts/sign-and-notarize.sh

Outputs CodexBar-<version>.zip ready to ship. Adjust APP_IDENTITY in the script if needed.

Account details stay local and per-provider:

• Codex: email/plan come from the codex RPC response; falls back to decoding ~/.codex/auth.json (JWT only) if the RPC is unavailable.
• Claude: email/org/login method are pulled from the Claude CLI /status output.
• We never mix provider data (no showing Claude org in Codex mode, etc.). Nothing is sent anywhere.

• Codex: if Codex hasn’t returned rate limits yet, you’ll see “No usage yet.” Run one Codex prompt and refresh.
• Codex: if the event schema changes, percentages may fail to parse; the menu will show the error string while keeping cached credits.
• Claude: if the CLI is missing or not logged in you’ll see the CLI error (e.g., “Claude CLI is not installed” or “claude login”).
• Claude: reset strings sometimes omit time zones; we surface the raw text when parsing fails.
• Only arm64 build is scripted; add --arch x86_64 if you want a universal binary.

See docs/RELEASING.md for the full CodexBar release flow, including signing, notarization, appcast generation, and asset validation.

See CHANGELOG.md.

• ✂️ Trimmy — “Paste once, run once.” Flatten multi-line shell snippets so they paste and run.
• 🧳 MCPorter — TypeScript toolkit + CLI for Model Context Protocol servers.
• Cross-promote: Download CodexBar at codexbar.app and Trimmy at trimmy.app.

Inspired by ccusage (MIT), specifically the cost usage tracking.

License: MIT • Peter Steinberger (steipete)