AI Usage Bar adds live usage information for AI coding tools to the VS Code status bar. It shows quota windows, rate limits, reset times, billing usage, and API balances for the providers you enable.
This project is forked from UsageBar, inspired by CodexBar. See Credits for details.
Features
- One status-bar item per provider. See usage percentage or balance at a glance, with provider icons and configurable progress bars.
- Useful details on click. Open a compact detail view with quota windows, reset times, billing information, and direct links to the provider portal.
- Five supported providers. Claude Code, OpenAI Codex CLI, Mistral, DeepSeek, and Antigravity (Google Cloud Code).
- Automatic refresh. Choose manual refreshes or intervals from one to 30 minutes.
- Private credentials. API keys and cookies are stored in VS Code Secret Storage, backed by the operating-system keychain.
- Native configuration. Configure sources and display preferences through standard VS Code settings.
Requirements
- VS Code 1.125 or later.
- An account and supported authentication method for each provider you want to use.
- For Antigravity OAuth, the optional
antigravity-usage CLI.
Install
From a release
Download the .vsix asset from the latest GitHub Release, then run:
code --install-extension ai-usage-bar-<version>.vsix
You can also use Extensions: Install from VSIX... from the VS Code Command Palette.
From source
git clone https://github.com/w-osilva/smart-usage-bar
cd smart-usage-bar
npm install
npm run compile
Press F5 in VS Code to start an Extension Development Host.
Quick start
Enable the providers you use in Settings (Ctrl+, / Cmd+,) by searching for AI Usage Bar. Most CLI-based providers work as soon as you have logged in through their own CLI.
| Provider |
What AI Usage Bar tracks |
Setup |
| Claude Code |
Session, weekly, and model-specific quota windows |
Run claude login; credentials are read from the local Claude CLI session. |
| OpenAI Codex CLI |
Monthly quota and reset information |
Run codex login; credentials are read from the local Codex CLI session. |
| Mistral |
Vibe plan quota or monthly billing spend |
Import a browser session cookie automatically on macOS Firefox, or set it manually. |
| DeepSeek |
API credit balance and monthly cost |
Set DEEPSEEK_API_KEY or use AI Usage Bar: Set DeepSeek API Key. |
| Antigravity |
Gemini and Claude/GPT quota groups and reset times |
Install antigravity-usage and run antigravity-usage login, or use a running Antigravity language server. |
Mistral manual setup
- Open Mistral Console.
- In browser developer tools, open Network, select a request, and copy its full
Cookie header value.
- Run AI Usage Bar: Set Mistral Admin Cookie from the Command Palette.
Click the Mistral status-bar item to toggle or inspect Vibe quota and billing data.
Antigravity setup
npm install -g antigravity-usage
antigravity-usage login
AI Usage Bar refreshes the CLI-managed OAuth token automatically. Use usagebar.providers.antigravity.group to choose the primary status-bar group: gemini or claude (Claude and GPT share a pool).
Commands
| Command |
Purpose |
AI Usage Bar: Refresh All Providers |
Fetch fresh data from every enabled provider. |
AI Usage Bar: Open Settings |
Open the extension settings. |
AI Usage Bar: Show Provider Detail |
Open the selected provider's detail view. |
AI Usage Bar: Toggle Mistral Vibe / Billing |
Switch Mistral's primary metric. |
AI Usage Bar: Set Claude Session Cookie |
Save a Claude web-session cookie. |
AI Usage Bar: Set Mistral Admin Cookie |
Save a Mistral browser-session cookie. |
AI Usage Bar: Set DeepSeek API Key |
Save a DeepSeek API key. |
AI Usage Bar: Set Antigravity OAuth Token |
Save an Antigravity OAuth token manually. |
AI Usage Bar: Refresh Antigravity Token via gcloud |
Refresh the Antigravity token. |
AI Usage Bar: Clear All Secrets |
Remove all credentials saved by the extension. |
Settings
| Setting |
Default |
Description |
usagebar.refreshInterval |
5m |
manual, 1m, 2m, 5m, 15m, or 30m. |
usagebar.display.iconOnly |
false |
Show only the provider icon — usage numbers stay in the tooltip and detail panel. |
usagebar.display.showProviderLabel |
true |
Show the provider name in the status bar. |
usagebar.display.statusBarPriority |
99 |
Placement priority. On the right side, higher values are further left; lower it to move AI Usage Bar further right. |
usagebar.display.progressBarStyle |
blocks |
blocks, dots, or percent. |
usagebar.display.percentMode |
used |
Show quota used or remaining. |
usagebar.providers.<provider>.enabled |
true |
Enable an individual provider. |
usagebar.providers.claude.source |
auto |
Choose Claude OAuth, web cookie, or CLI lookup. |
usagebar.providers.codex.source |
auto |
Choose Codex OAuth or CLI lookup. |
usagebar.providers.mistral.metric |
billing |
Show monthly billing or Vibe quota. |
usagebar.providers.mistral.cookieSource |
auto |
Automatically import or manually provide the cookie. |
usagebar.providers.antigravity.source |
auto |
Choose automatic, CLI, or OAuth lookup. |
usagebar.providers.antigravity.group |
gemini |
Show the Gemini or Claude/GPT quota group. |
Release notes
See CHANGELOG.md for the complete history.
Releasing
Releases are intentional and local: the command bumps the semantic version, packages a VSIX, creates a commit and v<version> tag, pushes both, and creates a GitHub Release with the VSIX attached.
npm run release # patch
npm run release:minor
npm run release:major
The command requires a clean working tree, Node.js, npm, an authenticated Git remote, and GitHub CLI authentication for automatic GitHub Release creation. Upload the resulting VSIX to the VS Code Marketplace from the publisher dashboard.
Contributing
Issues and pull requests are welcome at w-osilva/smart-usage-bar. Please open an issue before starting a large change.
Credits
License
MIT
