GNOME Shell extension · free and open source

Every AI coding limit,
in your top bar.

UsageBar shows how much Claude, Codex, Gemini and Copilot quota you have left, when each window resets, and what you've spent. It sits in the GNOME panel, one glance away.

GNOME 46, 49 and 50 · Wayland and X11 · MIT licensed

A GNOME desktop with UsageBar open: provider chips in the top bar, a popover listing Claude, Codex, Gemini, Copilot and OpenRouter with their remaining quota, and the spend dashboard beside it.

Around 60 providers, including

  • Claude
  • Codex
  • Gemini
  • Copilot
  • Cursor
  • OpenRouter
  • OpenCode
  • z.ai
  • Kiro
  • Mistral
  • DeepSeek
  • Grok
  • Windsurf
  • Warp
  • Ollama
  • JetBrains AI

Top bar and popover

The warning before the rate limit.

Each provider gets a chip in the top bar: a ring that fills as you use up a window and turns from green to yellow to red. Click it to see every provider at once, with what's left in each window and when it resets.

  • Session, weekly and monthly windows side by side
  • Plan badges such as Max 20x, Plus and Pro
  • One chip per provider, or a single chip for whichever is closest to its limit
The UsageBar popover: total spend for the last 30 days, then one row per provider with its plan, remaining quota per window and reset countdown.

Provider detail

Will this window last until it resets?

Open a provider for every rate window it reports, including per-model limits like Claude's Sonnet-only week. Pace compares how fast you're going with how much time is left, and says when you'd run out.

  • Reset countdowns, relative or as clock times
  • Today and 90-day spend, with a daily chart and top models
  • A 45-day strip of the provider's own incidents
The Claude detail view: session, weekly and Sonnet-only bars with pace, spend and token totals, a daily cost chart, and a status history strip.

Spend dashboard

What your tokens would have cost.

UsageBar reads the agent session logs on your machine and prices them at API rates: cost and tokens per day, per provider and per model, for today or the last 7, 30 or 90 days. It's an estimate from local logs, so it can differ from your bill.

The spend dashboard: raw token cost for 30 days split between Claude and Codex, a daily cost chart, token totals, and a per-model breakdown.

Settings

Set up like the rest of GNOME.

A native Settings window, no config files. Turn providers on and off, pick what the chips show, set the warning thresholds and the refresh interval, and choose which windows deserve a notification.

  • Follows the GNOME Shell style, light or dark, or keeps its own dark theme
  • Hide personal information before you share your screen
UsageBar's Settings window on the General page, with theme and panel chip options.
  • Quota notifications

    A desktop notification at the thresholds you choose, separately for session and weekly windows. Once per threshold, then nothing until the window resets.

  • Several accounts per provider

    Two Claude subscriptions or three OpenRouter keys each get their own row and their own quota. Switch the Claude account that Claude Code uses from the card.

  • Useful when a provider isn't

    When a fetch is rate limited or fails, UsageBar keeps the last good numbers on screen, greyed and marked, and says in plain words what needs fixing.

  • Local by default

    The extension runs its own helper on 127.0.0.1 and talks to the providers you turn on. No telemetry, no UsageBar account.

  • Your existing sign-ins

    It reuses the logins you already have: Claude Code, the Codex CLI, API keys. Claude and Codex are switched on for you if you're signed in.

  • Not on GNOME?

    A tray app covers KDE, XFCE and other desktops. On macOS, use CodexBar, the project UsageBar is built on.

Machine Sync

One total for all your machines.

Spend is counted from the logs of the machine that did the work. Machine Sync shares it between your desktop, your laptop and that build box, so each one shows the total and which machine spent what. It updates about every 2½ minutes.

The Machines view: Desktop, Laptop and Build box with today's spend, 30-day spend and share of the total.
The Machine Sync page in Settings: the Sync Server, the Pairing Link, Sync now, and this machine's name.
  1. Create a Sync Group

    In Settings → Machine Sync, enter your Sync Server's address. UsageBar makes the group's key on your machine.

  2. Pair your other machines

    Paste the Pairing Link on each one. There's no account and no password; the link is the key.

  3. See all of them

    Every machine shows up with today's spend, its 30 days and its share, in the popover and the dashboard.

End-to-end encrypted

Your machines encrypt every record with a key that never leaves them (ChaCha20-Poly1305, derived from the Pairing Link) before uploading it. The server stores what it can't read, whoever runs it.

Only spend is synced. Quota, credentials, project names, file paths and log content stay where they are.

Read the protocol

A Sync Server can see

  • Group and machine IDs
  • Which days a machine had spend
  • Record sizes, write times and IP addresses

It can't see

  • Amounts or token counts
  • Providers or models
  • Machine names

Run your own

Free

UsageBar works with any server that speaks the Machine Sync protocol. The app doesn't name or prefer one.

  • Open protocol, with test vectors
  • Fine on a tailnet or behind your own TLS proxy
  • The data stays on your hardware
Protocol spec

Hosted Sync

$2 / month

A Sync Server run for you. Nothing to install or keep online.

  • One Sync Group, up to 10 machines
  • 400 days of history
  • 14-day free trial, no card needed
  • After you cancel, your machines can still read their data for 30 days
Start the free trial

Install

Two minutes, one logout.

UsageBar needs GNOME 46, 49 or 50: Ubuntu 24.04, 25.10 or 26.04, or Fedora 43 or 44. The package holds the extension and its command-line helper.

Ubuntu and Debian

Download the .deb from the latest release, then:

sudo apt install ./usagebar_*.deb

Fedora

Download the .rpm from the latest release, then:

sudo dnf install ./usagebar-*.rpm

Just the CLI, any distro

The usagebar command on its own, with Machine Sync, for servers and other desktops. It installs into ~/.local and checks the download's checksum.

curl -fsSL https://raw.githubusercontent.com/felipearosr/UsageBar/main/linux/packaging/install-cli.sh | sh

Log out and back in once after installing the package. UsageBar then turns itself on. It isn't on extensions.gnome.org yet.

FAQ

Questions people ask first.

Where do the numbers come from?

Quota comes from each provider's own API, using the sign-in you already have on this machine. Spend is estimated from the agent session logs on your disk, priced at API rates.

Does UsageBar send my data anywhere?

No telemetry and no analytics. It talks to the providers you turn on and to their public status pages. If you pair it, it also sends encrypted spend to the Sync Server you chose, and nothing else.

Do all providers work on Linux?

Any provider that signs in with a token, an API key or its own CLI works. A few whose only data source is a macOS browser cookie or the macOS Keychain show an error row in place of numbers.

How is UsageBar related to CodexBar?

UsageBar is a fork of CodexBar by Peter Steinberger, the macOS menu bar app whose provider integrations it uses. The fork adds the GNOME extension, a tray app and Machine Sync, and merges each upstream release. On macOS, use CodexBar.

Is it affiliated with Anthropic, OpenAI or another provider?

No. UsageBar is an independent open-source project. Provider names and logos belong to their owners.

Can I use Machine Sync without paying?

Yes. The protocol is public, and UsageBar pairs with any server that implements it. Hosted Sync is there if you'd rather not run one.