Provider switcher
Find your provider by its logo and mini usage bar. Tabs remain available while fresh data loads, so a pending probe does not block switching.
USAGESTAT BAR / YOUR DESKTOP COMPANION
A small bar.
A clearer head.
Your AI usage, right on your desktop. Keep the numbers you care about visible, look a little closer when you need to, and stay in your flow.
12desktop integrations
Localpowered by UsageStat
MITlicensed
Select a provider in the capture to explore.
Codex. Session: 76% left. Resets 2h 46m. Weekly: 62% left. Resets Thu 09:00.
WINDOWS, MACOS & LINUX. ONE BAR.
At home on your desktop.
Your Windows system tray, macOS menu bar, or Linux desktop panel. Explore the Linux previews for GNOME, KDE Plasma, Cinnamon, MATE, Xfce, LXQt, Budgie, COSMIC, Sway, Hyprland, i3, and bspwm, each with its own styling and chosen background.
| System / desktop | Integration | Get started |
|---|---|---|
| Windows | System tray app | Install |
| macOS | Menu bar app | Install |
| GNOME | Shell extension | Try it |
| KDE Plasma | Plasma 6.4+ widget | Try it |
| Cinnamon | Panel applet | Try it |
| MATE | Panel applet | Try it |
| Xfce | Native panel plugin | Try it |
| LXQt | Status tray | Try it |
| Budgie | System tray | Try it |
| COSMIC | Status area | Try it |
| Sway | Native Waybar widget | Try it |
| Hyprland | Native Waybar widget | Try it |
| i3 | Polybar | Try it |
| bspwm | Polybar | Try it |
Other Linux desktops can use the shared tray integration with a StatusNotifier host. All integrations share the same backend and provider settings.
Linux desktop validation · 8 September 2026
The latest interaction report checks all 12 integrations. GNOME, Plasma, Cinnamon, MATE, Xfce, LXQt, Sway, Budgie, i3, and bspwm passed their supported checks. Native panel widgets support all four edges; GNOME uses its top panel, and the Polybar profiles use top or bottom placement.
Hyprland still has a repeated-click issue after its popup takes focus. COSMIC’s test session was blocked by a compositor crash and needs a healthy session for full validation. These browser demos use sample data and do not reproduce compositor behavior.
Read the interaction report ↗YOUR PROVIDERS. YOUR STYLE. YOUR RULES.
Make it unmistakably yours.
A quiet logo, a row of useful numbers, or colors that feel at home on your desktop. Change the layout, the details, and the way you read your usage. Open the interactive demo whenever you want to try it for yourself.
JUST ENOUGH INFORMATION.
Everything in
its right place.
Build a panel indicator from the components you actually want. Keep one provider in view, or make room for several. Explore layouts captured directly from the extension.
- Choose your components. Meters, percentages, logos, and names, in the order you prefer.
- Pin your favorites. Keep fixed providers next to slots that cycle through the rest.
- Choose your windows. Show more than one usage bar per provider and arrange them horizontally or vertically.
- Use your space. Set the panel position, index, provider spacing, and popup alignment.
- Make the logo useful. Display a full, vertically filled, horizontally filled, or pie-style logo.
Make your panel yoursCURRENT GNOME VERSION
Codex pinned beside Claude, with a logo, two stacked usage meters, and a percentage each.
Captured from the extension with sample data. Configure your own layout in UsageStat Bar preferences.
A LITTLE CLOSER, WHEN YOU NEED IT.
One click.
The rest of the picture.
Open the popup to switch providers, inspect individual usage windows, and see the information behind the panel meter.
Usage windows
See session, weekly, and other provider-specific meters. Choose which trackers appear and which usage window drives each provider’s panel indicator.
Reset countdowns
See when a quota resets, along with when the provider was last refreshed. Choose your preferred reset-time display in preferences.
Credit & cost rows
Keep supported credit, balance, quota, and spend rows visible, or hide the ones you do not need. Available rows follow the provider’s reported data.
Pace at a glance
Show the backend’s pace information where the provider supports it, indicating usage relative to the expected rate through the quota window.
Useful shortcuts
Refresh data, jump to the active provider’s preferences, or open its usage dashboard and status page when links are available. Scroll within the popup to switch providers.
YOUR DEFINITION OF “GETTING CLOSE.”
A heads-up
at the right moment.
Create usage thresholds with a name, percentage used, and color. Turn notifications on for the thresholds that matter to you.
- Custom thresholds. Add and delete states instead of being limited to the defaults.
- Matched colors. Use the color picker or a hex value; both controls stay in sync.
- Upward crossings. Notifications are triggered as usage moves up into a threshold, when enabled.
- Quiet by default. The default warning, danger, and limit thresholds have notifications turned off.
Default thresholdsPERCENT USED
Warning
Notifications off75%
Notifications off75%
Danger
Notifications off90%
Notifications off90%
Limit reached
Notifications off100%
Notifications off100%
Threshold controls are implemented. The project’s feature checklist still calls for broader validation with real provider data and edge cases.
YOUR ACCOUNTS DON’T ALL LOOK THE SAME.
Give every source
a place of its own.
The bar discovers providers through the backend. Preferences let you organize the installed integrations and add the sources that fit your workflow.
Choose what appears
Enable, disable, hide, and drag-reorder providers. Enabled, disabled, plugin, and hidden sections help keep a large provider list manageable.
Several accounts or sources
Create a named provider instance as a separate switcher tab, or group extra sources inside an existing provider tab. Reorder the child sections independently.
API token tracking
Add API tracking as another source when the provider supports API keys, or switch an existing source to the available API mode.
Custom command providers
Connect a command that prints a UsageStat-style usage JSON object or array. Give the source a name and remove it later without deleting the built-in provider.
Provider support follows your backend. The bar can only display the data your installed plugins and authenticated sources return. Some provider metadata and newer integrations require a source-build backend.
NATIVE PREFERENCES. PLENTY OF ROOM TO ADJUST.
The complete
set of controls.
From individual icons to the way you move between accounts, every setting has a place. Open a category to see what you can change and where to find it in the GNOME preferences. Linux ports share the same provider settings, with separate controls for tray icons.
01Placement & componentsDecide where the bar lives and exactly how much space it takes.
Appearance → Panel / Top Bar Components
- Panel position
- Left, center, or right; position index from 0–20 within the chosen panel box.
- Popup alignment
- Align the popup left, center, or right relative to its panel indicator.
- Visible components
- Show or hide the meter, percentage, provider logo, and provider name. Drag enabled components into any order.
- Provider count
- Show 1–3 providers together, with 0–16 px spacing between them.
- Pinned providers
- Pin and drag-reorder favorites before the scrolling slots. Keep at least one slot free to cycle through other providers.
- Usage bars
- Choose 1–3 bars per provider, where data is available. Arrange them as vertical or horizontal stacks.
02Colors & provider identityMatch your panel, recognize providers your way, and let the logo carry useful information.
Appearance → Provider Icons / Appearance Colors; Providers → a provider
- Normal meter color
- Choose the color of usage meters below your first threshold.
- Text and outlines
- Choose a separate color for panel text, meter outlines, and monochrome provider icons.
- Color picker or hex
- Use the native color picker or enter a six-digit hex color. The two inputs stay in sync.
- Global icon style
- Choose color or monochromatic logos. Each provider can follow the default or override it.
- Logo fill
- Full, vertical, horizontal, or pie fill. Partial fills follow the selected used or remaining percentage.
- Alternative marks
- Choose Codex or OpenAI, Claude or Claude Code, and Microsoft Copilot or GitHub Copilot logos.
- Custom source icons
- Choose your own SVG for a custom command provider, or clear it to restore the fallback icon.
03Meters & popup contentKeep the metrics you need and give your panel a clear meaning.
Behaviour → Data / Popup; Providers → a provider
- Meter meaning
- Show remaining quota or used quota across the main usage displays.
- Panel usage window
- Session is the default when available. Choose another tracker or use Auto, which averages visible main quota windows and can fall back to extra usage when the primary quota is exhausted.
- Usage trackers
- Toggle individual session, weekly, and provider-specific meters in the popup and automatic meter.
- Credits and cost
- Individually show or hide discovered credit, balance, quota, and spending rows.
- Pace
- Show or hide the pace indicator when the backend supplies it.
- Header shortcuts
- Independently show or hide available usage-dashboard and status-page buttons.
04Thresholds & notificationsDefine what normal, getting close, and time to stop mean for you.
Appearance → Thresholds
- Your own states
- Add, name, edit, and delete usage thresholds. Thresholds are ordered by percentage used.
- Trigger percentage
- Set each threshold from 0–100% used. Thresholds still track usage when meters show remaining quota.
- A color for each state
- Give every threshold its own color using a picker or hex value.
- Notifications per threshold
- Enable alerts only for the states you care about. Alerts fire when usage crosses upward into an enabled threshold.
- Starting defaults
- Warning at 75%, danger at 90%, and limit reached at 100%, with notifications off by default.
05Timing & interactionChoose when data updates, how resets read, and how you move between providers.
Behaviour → Data / Interaction; Tools → Terminal
- Refresh interval
- Choose 1–1,440 minutes between CLI refreshes, or refresh immediately from the popup.
- Reset display
- Smart, relative, time only, day and time, or date and time. Smart includes the weekday for weekly resets.
- Panel scrolling
- Enable or disable scrolling on the panel indicator to cycle through unpinned providers.
- Popup scrolling
- Control popup scrolling separately. It can cycle through all providers, including pinned ones.
- Preferred terminal
- Use automatic terminal detection or choose an available terminal for CLI tools.
- Backend paths
- Auto-detect or choose the UsageStat executable and plugin directory for your installation.
06Providers, accounts & sourcesBuild a provider list around the accounts and tools you actually use.
Providers
- Your provider order
- Enable, disable, hide, and drag-reorder providers. Hidden providers remain available to restore.
- Display names
- Rename providers and additional sources so the panel and popup use the names that make sense to you.
- Named sources
- Add named provider instances for additional accounts or supported authentication sources.
- Grouped tabs
- Group extra accounts, API tracking, or custom sources under one parent provider tab, then reorder the child sections.
- Source selection
- Choose among the authentication and tracking methods supported by each provider, such as CLI, OAuth, web, API, or local data.
- Custom commands
- Add a command that returns UsageStat-style JSON and give the source a name and icon.
- Per-provider choices
- Give each provider its own icon style, panel tracker, visible meters, and credit or cost rows.
Preference availability follows the selected integration. Each demo uses its desktop’s default appearance, independently of this website’s light/dark setting.
LESS FRICTION WHEN SETTING UP.
A few useful tools,
right where you need them.
CLI detection & checks
Auto-detect the usagestat executable or select a custom path. See the detected version or launch status, and copy the resolved path.
Plugin directory checks
Use automatic plugin discovery or select a folder. Inspect the discovered provider count and surface missing or invalid plugin setup.
Terminal shortcuts
Choose an available terminal and launch configuration validation, provider listing, usage, status, cost summaries, JSON/CSV exports, cache clearing, or CLI help.
The extension runs the installed CLI for usage. It does not require the background daemon; the daemon is for the backend dashboard, HTTP API, and T3 bridge.
BUILT IN THE OPEN.
A bar you can
make better.
For the GNOME integration, use the development link for local work, compile changed schemas, test in a nested GNOME Shell, and build a submission ZIP with the included helpers.
./dev-link.shlinks the working checkout into your extensions directory.glib-compile-schemas schemasrebuilds changed settings schemas../test-nested.shand the shell helpers support development testing../build.shassembles the extension ZIP.
Beyond GNOME
The Linux ports include native panel widgets, shared GTK preferences, tray integration, and Waybar and Polybar modules. Desktop labs and disposable VM tests cover Linux installation and interaction. Windows uses the system tray, and macOS uses the menu bar.
Follow desktop developmentWhat’s still being refined
The project tracks further threshold validation, notification wording and frequency controls, richer account setup, and additional provider-specific presets. These are ongoing work rather than promised release features.
Feature checklistMake a little room for clarity.
Your providers, your order, your panel.
Feature reference: UsageStat Bar’s README, feature checklist, preferences, and settings schema.