aqua5230/usage

usage is a small Mac menu-bar application that shows how much of your Claude Code and OpenAI Codex CLI quota you have used. It pins a tiny percentage in the top-right of the screen, and clicking it opens a popover with session usage, weekly usage, the projects that used the most recently, and today's token count and a cost estimate. The README, written in Traditional Chinese with an English version available, is aimed at giving non-technical Mac users a clear walkthrough. The key design choice is that the numbers do not come from calling the Anthropic or OpenAI API. They come from log files the two CLIs leave on your own machine. For Claude Code, usage installs a small script called a statusLine hook, which Claude Code runs every time it refreshes its status bar. The hook receives the same JSON that Claude Code itself uses, writes it to ~/.claude/usage-status.json, and the menu-bar app reads from that file. For Codex, which has no equivalent hook, usage scans the conversation log files under ~/.codex/sessions/ and reads the rate_limits and token totals each conversation records. The only time usage talks to the network is when it needs to estimate a Codex cost and the local pricing cache at ~/.claude/pricing_cache.json is missing. In that case it downloads a public price table from the LiteLLM project, stores it, and refreshes it once a week. If that download fails it falls back to a built-in price table. Anthropic and OpenAI API keys are never read, and the macOS Keychain is never touched. There is a packaged .app on the Releases page that you drag to /Applications. Because it is not signed, the first launch needs a Ctrl-click and Open through Finder to get past Gatekeeper. The popover then offers an install hook button that wires up the Claude Code side for you. Developers running from source create a Python 3.13 virtual environment, run pip install -e ., and then python3 main.py --setup to install the hook. There is also a terminal-only TUI mode with a pixel-art Claude logo and a spinner, a --mock flag for previewing the UI with fake data, and a LaunchAgent script that starts usage automatically when you log in. The project is released under AGPL-3.0.