Connect your accounts.
Read the figures with context.
Use this guide to add your accounts, recognise each one and check whether a reading is current.
This Mac App Store edition reads selected local logs, usage file imports, manual readings and supported usage APIs. It does not connect through external CLIs or browser sessions, or send requests to start idle usage windows.
Requirements and download
TibTib AI Usage Watch is a free native menu bar app for macOS 14 or later. It's free on the Mac App Store and needs an Apple silicon Mac. Each AI tool's accounts and plan charges are separate.
Install it from the Mac App Store before enabling Open at login. You'll find the app in the menu bar, without a Dock icon. If it's already running, opening it from Finder brings Preferences forward.
Add your accounts
- Claude: import an exported usage JSON file, or save a manual allowance reading from your Claude dashboard.
- Codex: select the local Codex logs to read, import a usage file with banked reset data, or save a manual reading.
- Cursor: import a usage file, or save a manual reading from your Cursor dashboard.
- Grok: select the Grok directory containing
logs/unified.jsonl. Run Grok to update the billing reading in that log. - GitHub Copilot and Gemini CLI: import a usage file, or save a manual reading.
- OpenCode: save an OpenCode Console service account key to read workspace API spending, or import a usage file.
- Windsurf / Devin: save an enterprise Analytics Read key to read team consumption, or import or enter a personal reading.
Each connection reads the information its source provides. Saved API keys use macOS Keychain. The website preview never accesses your accounts.
Personal and work accounts together
Open Preferences… from the menu, or press ⌘,. Each account has a label, AI tool, connection, color and letter. Use + to add an account. Choose its AI tool and connection, then test the reading.
For another login, add another account row with its own usage file, selected logs or manual reading.
Extra accounts add columns with up to three rows each. Use letters and colors to recognise them. General settings let you adjust refresh timing, percentage markers, letters and warnings for supported Codex banked reset expiry data.
Understand the bars
The filled part means remaining allowance. There's no filled bar at 0% remaining. Color identifies the account. Click for percentages, available reset times, usage window details and reading status.
Claude readings can show weekly allowance and five-hour details. Codex shows the main weekly limit. Cursor uses included usage without a named usage period. Grok reads weekly credits from the logs you select. Percentages from different AI tools don't represent equivalent numbers of tokens, prompts or dollars.
Check Codex banked reset expiry dates
When an imported Codex usage file includes banked resets and expiry dates, TibTib AI Usage Watch can show a warning dot beside the account before the next banked reset expires. Open the menu for the available count and expiry information. An unused banked reset can be lost at expiry; this is separate from the normal time when your weekly allowance resets.
Enable Warn before reset in Preferences and choose 1–14 days ahead. The default is two days with a red dot; you can change its color. The dot remains visible with account letters off. Warnings need the app running, warnings enabled and current expiry data. The app doesn't use banked resets automatically or send a system notification.
If a reading is missing, old or unexpected
- Saved reading: the last good reading is saved on your Mac and restored on launch. After a failed refresh, the menu shows its age.
- Rate limit or connection failure: retries back off for 15 minutes after a rate limit and 2 minutes after other errors. Refresh now bypasses that backoff.
- Imported file: check that the file is still in place and was updated. A reading keeps its recording time, so an old file can't look live.
- Grok: run Grok to record a new usage reading. The app labels older logs and expired windows as historical.
- Codex: check that the selected logs are current, or import a newer usage file.
AI tools can change their data formats. The displayed figure doesn't guarantee your next request will succeed. Check your account page with that tool if the balance or reset looks wrong.
Local settings and connections
Preferences and cached readings stay on your Mac. Saved API keys use macOS Keychain. Read the privacy policy for information about your app settings and the information you share with us.
Report a problem
TibTib AI Usage Watch support can help. Include your app and macOS versions, AI tool, reading status and steps to reproduce the issue. Remove tokens, private account paths and other sensitive information. Don't send credential files.
TibTib AI Usage Watch — Support
Send us a message about a connection, a reading that looks wrong or an idea for the app.