A macOS menu bar usage monitor for OpenAI Codex and AI coding agents.
TokenBar keeps coding-agent usage visible while you work: tokens, quota pressure, reset timing, forecasted spend, and daily work rhythm from a compact macOS icon-bar surface.
It is built for heavy OpenAI Codex users first, with future connector surfaces for Claude by Anthropic, Cursor, Google coding agents, and other agentic development tools once explicit usage APIs or local exports are available.
Install TokenBar and the terminal launcher:
curl -fsSL https://raw.githubusercontent.com/Arnie016/TokenBar/main/install.sh | bashThen open it from any terminal:
tokenbarThe launcher installs TokenBar into ~/Applications and adds tokenbar under ~/.local/bin. Launching it opens the macOS app, plays a short terminal movie, then drops into a small TokenBar › prompt where you can ask about usage, cost, energy, providers, diagnostics, or installation.
TokenBar › usage
TokenBar › cost
TokenBar › energy
TokenBar › providers
TokenBar › quit
Optional sound cues:
tokenbar --soundThe audio uses built-in macOS sounds only and is off by default.
Coding agents are becoming part of daily software work, but usage limits and cost burn are still too easy to lose track of. TokenBar makes that invisible layer visible from the menu bar, so builders can see when Codex is healthy, when weekly pressure is tight, and how current usage might project forward.
- OpenAI Codex token usage from local session logs
- 5-hour and weekly quota pressure
- Daily token history with peak-day highlighting
- Estimated dollar usage from local token counts
- Forecast views for usage pace and spend
- Quick Insights for today, weekly pressure, peak day, average day, and projected cost
The overview is designed as a compact data-storytelling surface. The default view is a proper history line chart with a dotted projection line. Use the arrow controls to move through different views of the same usage data, including cost forecast, work rhythm, cumulative usage, spike detection, heat blocks, pace against average, peak share, weekly burn, and agent activity.
TokenBar currently reads OpenAI Codex usage locally. Claude by Anthropic, Cursor, Google coding agents, and other coding-agent surfaces are shown as future connector targets until explicit usage APIs or local exports are wired in.
Browser sign-in is not treated as usage authorization. TokenBar does not read browser cookies, passwords, account secrets, or provider tokens.
OpenAI Codex, ChatGPT, Codex, AI coding agents, coding agent usage, token usage, token monitor, quota monitor, cost forecast, macOS menu bar app, SwiftUI, local-first, Claude Anthropic, Gemini, Cursor, Google coding agents, developer productivity, agentic coding, AI developer tools.
Latest macOS arm64 build:
After manual download, drag the app into ~/Applications or /Applications, then run:
tokenbarBecause this early build is ad-hoc signed, macOS may show a Gatekeeper warning on first open.
Early public build. The current app is local-first and focused on Codex. Exact billing, purchased credits, and organization-level usage should still be verified in the official provider dashboard.