{"slug": "usagebar-claude-code-and-codex-rate-limits-in-the-macos-menu-bar", "title": "UsageBar – Claude Code and Codex rate limits in the macOS menu bar", "summary": "Developer idark7 released UsageBar, a native Swift macOS menu bar app that displays live 5-hour and weekly rate-limit usage for Anthropic's Claude Code and OpenAI's Codex, with notifications at 80% and 95% and a 24-hour usage sparkline. UsageBar reads Claude usage from the desktop app's plan-usage-history.json file sampled every ~15 minutes, from a claude_feed.json status line hook, or as a fallback from api.anthropic.com/api/oauth/usage using the Claude Code OAuth token, and reads Codex rate_limits entries from ~/.codex/sessions/**/*.jsonl. The app installs via 'brew install idark7/tap/usagebar' or a UsageBar-x.y.z.dmg release, and until it is notarized macOS requires a one-time right-click Open to launch it.", "body_md": "**Claude Code + Codex limits in your macOS menu bar. Never hit the 5‑hour wall by surprise again.**\n\n- Live 5‑hour and weekly usage for **Claude Code** and**Codex** , colour‑coded green / yellow / red\n- **Zero setup** — if you use the Claude desktop app, it just works. No login, no API token.\n- Native **notifications** at 80 % and 95 %, and when a window resets\n- **24h sparkline** of your Claude usage\n- Three menu bar styles: two‑line pill, compact `C89 X100` , or gauge rings\n- Countdown to reset in the menu bar when you're nearly out\n- Show % remaining (default) or % used\n- Click a row to open the provider's usage page\n- Launch at login, configurable auto‑refresh, single native Swift binary (no Python, no Electron)\n\n```\nbrew install idark7/tap/usagebar\n```\n\nor download the latest `UsageBar-x.y.z.dmg` from [Releases](https://github.com/idark7/UsageBar/releases), drag to Applications.\n\nUntil the app is notarized, macOS will say it \"can't be opened\". Right‑click the app → **Open** once, or\nallow it under *System Settings → Privacy & Security*.\n\nOr build it yourself (needs Xcode command line tools):\n\n```\n./build.sh            # → build/UsageBar.app and build/UsageBar-<version>.dmg\n```\n\n| Provider | Source | Needs | \n|---|---|---|\n| Claude | `~/Library/Application Support/Claude/plan-usage-history.json` , sampled every ~15 min by the Claude desktop app | Claude app installed and signed in | \n| Claude | `claude_feed.json` written by the optional Claude Code status line hook (adds exact reset times) | see below | \n| Claude | `api.anthropic.com/api/oauth/usage` with the Claude Code OAuth token | fallback only | \n| Codex | `rate_limits` entries in`~/.codex/sessions/**/*.jsonl` | Codex CLI | \n\nWhichever local source is freshest wins. When only the desktop‑app sample is available, the 5‑hour reset time is estimated from when the window started (shown as \"≈\").\n\nAdd the status line hook to `~/.claude/settings.json`:\n\n```\n\"statusLine\": {\n  \"type\": \"command\",\n  \"command\": \"/usr/bin/python3 \\\"/path/to/UsageBar/usagebar_statusline.py\\\"\"\n}\n```\n\nIt also gives you a `Opus | 5h 11% | wk 26% | project` status line in the terminal.\n\nTag `vX.Y.Z` and push; the GitHub Action builds a universal DMG and attaches it to the release.\n`UsageBar --snapshot out.png` renders the dropdown for docs. Add `MACOS_CERT_P12`, `MACOS_CERT_PASSWORD`, `MACOS_SIGN_ID`, `APPLE_ID`, `APPLE_TEAM_ID`,\n`APPLE_APP_PASSWORD` secrets to get Developer ID signing + notarization.\n\nMIT", "url": "https://wpnews.pro/news/usagebar-claude-code-and-codex-rate-limits-in-the-macos-menu-bar", "canonical_source": "https://github.com/idark7/UsageBar", "published_at": "2026-09-21 13:41:11+00:00", "updated_at": "2026-09-21 13:54:04.792421+00:00", "lang": "en", "topics": ["ai-tools", "ai-products", "developer-tools", "ai-agents"], "entities": ["UsageBar", "idark7", "Claude Code", "Codex", "Anthropic", "OpenAI", "macOS", "GitHub"], "alternates": {"html": "https://wpnews.pro/news/usagebar-claude-code-and-codex-rate-limits-in-the-macos-menu-bar", "markdown": "https://wpnews.pro/news/usagebar-claude-code-and-codex-rate-limits-in-the-macos-menu-bar.md", "text": "https://wpnews.pro/news/usagebar-claude-code-and-codex-rate-limits-in-the-macos-menu-bar.txt", "jsonld": "https://wpnews.pro/news/usagebar-claude-code-and-codex-rate-limits-in-the-macos-menu-bar.jsonld"}}