arnie016/tokenbar

TokenBar is a macOS menu bar application that tracks how much of your AI coding assistant's usage allowance you have consumed and shows that information in a small icon at the top of your screen. It is aimed at people who use OpenAI Codex heavily and want to stay aware of token limits, cost burn, and how their usage is trending over time. When running, it displays data pulled from local session logs rather than from any cloud account. You can see how many tokens you have used in the current five-hour window and over the week, a daily history chart with a dotted projection line, estimated dollar cost based on local token counts, and several alternative views of the same data including a cost forecast, a heat block view, and spike detection. A small terminal prompt lets you type commands like usage, cost, and providers to get quick summaries. Installation is a single curl command that downloads the app, places it in your Applications folder, and adds a tokenbar command to your terminal. The build is currently for Apple Silicon Macs only. Because it is an early ad-hoc signed build, macOS may show a security warning the first time you open it. The README is clear that only OpenAI Codex is supported right now. Claude, Cursor, and Google coding agents are listed as future targets, but no timeline is given and no connection exists yet. The app does not read browser cookies or account credentials of any kind. The project is at an early stage with no stars and a brief codebase. The README advises verifying exact billing numbers against the official provider dashboard rather than relying on TokenBar alone, since it works from local estimates rather than authoritative account data.