v1.0.0 — First release

🔋 Claude & Codex Usage Battery — v1.0.0

First public release. A macOS menu bar widget that shows your remaining Claude Code and Codex usage limits as battery icons — so you never have to open /usage again.

C = Claude · X = Codex. Each battery shows the remaining % of a limit window — full & green means plenty left, red means almost out. Click it for a detailed breakdown with reset times.

✨ Features

• Claude — 5-hour session · weekly · Fable (top-model weekly cap), read live from `usage-cache.json`
• Codex — 5-hour · weekly (or credit balance on the premium plan)
• Remaining-% with traffic-light colors (green ≥ 50%, amber < 50%, red < 20%)
• Click-through dropdown: per-limit gauges, reset times, today's cost/tokens by model
• Battery PNGs hand-encoded in pure JavaScript (`node:zlib` only) — no image library
• Zero dependencies, no network calls, no secrets — reads only local usage files
• Refreshes every 2 minutes at zero token cost (local reads only)
• Optional throttled background refresh for Codex when exhausted

📦 Requirements

macOS · SwiftBar · bun · Claude Code (Codex optional). `ccusage` is auto-installed.

🚀 Install

```bash
git clone https://github.com/dennykim123/claude-codex-battery.git
cd claude-codex-battery && ./install.sh
```

Full details in the README. MIT licensed — feedback and PRs welcome.