See your usage at a glance from your menu bar. No digging through dashboards.
Download the latest release (macOS Apple Silicon & Intel, Linux AppImage/.deb/.rpm)
The app auto-updates. Install once and you're set.
Linux notes: OpenUsage runs in the system tray. On desktops without StatusNotifierItem/AppIndicator support (e.g. GNOME without the AppIndicator extension) a left-click on the tray icon may not open the panel — use the tray menu's Show Stats entry or the global shortcut instead. The panel appears under the tray icon where the compositor allows it (best-effort on Wayland). Reading credentials stored in the system keyring requires
secret-tool(thelibsecret/libsecret-toolspackage).
Grab the asset for your distro from the latest release (replace the version in the examples below if a newer one is out).
Fedora / RHEL (.rpm) — dnf pulls in the dependencies automatically:
sudo dnf install https://github.com/symonbaikov/openusage/releases/download/v0.6.24/OpenUsage-0.6.24-1.x86_64.rpmDebian / Ubuntu (.deb):
curl -LO https://github.com/symonbaikov/openusage/releases/download/v0.6.24/OpenUsage_0.6.24_amd64.deb
sudo apt install ./OpenUsage_0.6.24_amd64.debAny distro (AppImage) — portable, no install:
curl -L -o OpenUsage.AppImage https://github.com/symonbaikov/openusage/releases/download/v0.6.24/OpenUsage_0.6.24_amd64.AppImage
chmod +x OpenUsage.AppImage
./OpenUsage.AppImageAfter installing via .rpm/.deb, launch OpenUsage from your app menu — it
starts in the system tray. If your desktop has no tray (e.g. GNOME), install an
AppIndicator/StatusNotifier extension, or open the panel with the global shortcut.
Runtime dependencies (handled automatically by .rpm/.deb): webkit2gtk-4.1,
gtk3, an AppIndicator library, and — for providers that read the system
keyring — secret-tool (libsecret-tools / libsecret).
OpenUsage lives in your menu bar and shows you how much of your AI coding subscriptions you've used. Progress bars, badges, and clear labels. No mental math required.
- One glance. All your AI tools, one panel.
- Always up-to-date. Refreshes automatically on a schedule you pick.
- Global shortcut. Toggle the panel from anywhere with a customizable keyboard shortcut.
- Lightweight. Opens instantly, stays out of your way.
- Plugin-based. New providers get added without updating the whole app.
- Local HTTP API. Other apps can read your usage data from
127.0.0.1:6736. - Proxy support. Route provider HTTP requests through a SOCKS5 or HTTP proxy.
- Amp / free tier, bonus, credits
- Antigravity / all models
- Claude / session, weekly, extra usage, local token usage (ccusage)
- Codex / session, weekly, reviews, credits
- Copilot / premium, chat, completions
- Cursor / credits, total usage, auto usage, API usage, on-demand, CLI auth
- Factory / Droid / standard, premium tokens
- Gemini / pro, flash, workspace/free/paid tier
- Grok / credits used, plan, pay-as-you-go cap
- JetBrains AI Assistant / quota, remaining
- Kiro / credits, bonus credits, overages
- Kimi Code / session, weekly
- MiniMax / coding plan session
- OpenCode Go / 5h, weekly, monthly spend limits
- Windsurf / prompt credits, flex credits
- Z.ai / session, weekly, web searches
Community contributions welcome.
Want a provider that's not listed? Open an issue.
OpenUsage is built by its users. Hundreds of people use it daily, and the project grows through community contributions: new providers, bug fixes, and ideas.
I maintain the project as a guide and quality gatekeeper, but this is your app as much as mine. If something is missing or broken, the best way to get it fixed is to contribute by opening an issue, or submitting a PR.
Plugins are currently bundled as we build our the API, but soon will be made flexible so you can build and load their own.
- Add a provider. Each one is just a plugin. See the Plugin API.
- Fix a bug. PRs welcome. Provide before/after screenshots.
- Request a feature. Open an issue and make your case.
Keep it simple. No feature creep, no AI-generated commit messages, test your changes.
Not a single line of code in this project was read or written by hand. 100% AI-generated, AI-reviewed, AI-shipped — using Cursor, Claude Code, and Codex CLI.
OpenUsage is a real-world example of what I teach in the AI Builder's Blueprint — a proven process for building and shipping software with AI, no coding background required.
OpenUsage is supported by our sponsors. Become a sponsor to get your logo here and on openusage.ai.
Inspired by CodexBar by @steipete. Same idea, very different approach.
Build from source
Warning: The
mainbranch may not be stable. It is merged directly without staging, so users are advised to use tagged versions for stable builds. Tagged versions are fully tested whilemainmay contain unreleased features.
Install the system libraries Tauri needs before building:
# Debian/Ubuntu
sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev \
libayatana-appindicator3-dev librsvg2-dev patchelf libsecret-1-dev build-essential
# Fedora
sudo dnf install -y webkit2gtk4.1-devel gtk3-devel libappindicator-gtk3-devel \
librsvg2-devel libsecret-devel patchelf...
