Skip to content

Releases: tylercrosse/cc-usage-bar

1.2 — Codex support, threshold notifications, refreshed UI

27 Jun 18:31
@tylercrosse tylercrosse
1.2
6b8e20f

Choose a tag to compare

View all tags
1.2 — Codex support, threshold notifications, refreshed UI Latest
Latest

First release on this fork. Builds on upstream 1.1.1 with Codex support, structured parsing, notifications, and a UI refresh.

What's new

Codex support

  • Stacked Claude Code + OpenAI Codex usage in one popover, each driven by its own CLI session
  • Provider abstraction holding all provider-specific CLI driving config — additional CLIs are pluggable without rewriting the flow
  • Codex is driven on timers rather than string detection (ratatui's char-by-char cursor positioning breaks banner matching; see docs/CODEX_INTEGRATION_NOTES.md for the full writeup)

Structured parsing & UI

  • /usage and /status output parsed into native metrics (percent used, reset times, credits) with raw terminal output as a fallback
  • Calmer violet / amber / coral palette with subtle vertical-gradient progress bars (replaces system green/orange/red)
  • Adaptive popover styling that follows the system appearance (light/dark)
  • Per-provider header links to the web usage pages

Notifications

  • macOS notifications when usage crosses 60% / 80% / 100% per metric
  • Per-metric state keyed by a stable resetIdentifier so a new reset window re-arms the thresholds instead of reusing stale state

Refresh behavior

  • Caching with stale-while-revalidate and a 5-minute background refresh timer
  • Reset details show relative time ("Resets in 4h 30m at 1:30pm …") for time-based windows, plus relative days for weekly windows

Build

  • build.sh for building and relaunching without Xcode (Command Line Tools only)
  • Parser tests

Install

Download CCUsageBar.zip below, unzip, and move CCUsageBar.app to /Applications.

Note: Not notarized — Gatekeeper will block first launch. Right-click → Open → Open, or run xattr -d com.apple.quarantine /Applications/CCUsageBar.app.

Requirements

  • macOS 14 Sonoma or later
  • claude on your PATH (required)
  • codex on your PATH (optional — the Codex panel shows a setup hint if absent)
Assets 3
Loading