OpenUsage WebUI — Linux CLI & Web Dashboard

Fork note: This is a Linux-compatible fork of OpenUsage. The original is a macOS Tauri menu bar app. This fork replaces the Tauri shell with a Bun server + React WebUI and a CLI status tool, so it runs on Ubuntu/Linux without Tauri or macOS-specific dependencies.

What's New

2026-06-29

• Credit Reset Sync: You can now see the exact date and live countdown for your credit reset on both the CLI and the web dashboard.
• WebUI Upgrades: We've made several visual and accessibility improvements to the web interface, including better navigation and improved text contrast for a smoother user experience.

Screenshots

Web Dashboard — every provider at a glance, with progress bars and reset timers:

Terminal Status — ou-status in your shell, with colored usage bars and Codex reset-credit expiry (live countdown + exact date, matching the dashboard):

Quick Start (Linux)

# Install Bun if you don't have it
curl -fsSL https://bun.sh/install | bash

# Clone and install
git clone https://github.com/solitude6060/openusage_webui.git
cd openusage_webui && bun install

# Start the WebUI (opens at http://127.0.0.1:6736)
bun run dev:webui

# Or check usage from terminal
bun run status
bun run status:refresh   # refresh all providers first

Terminal Alias (ou-status)

Add a shortcut so you can run the status tool from any directory. The same alias line works in both shells — put it in ~/.bashrc for bash, or ~/.zshrc for zsh:

alias ou-status='bun run --cwd /path/to/openusage_webui status'
alias ou-status-refresh='bun run --cwd /path/to/openusage_webui status:refresh'

Replace /path/to/openusage_webui with your clone path, then reload the shell (source ~/.bashrc or source ~/.zshrc). Now ou-status prints usage from anywhere, and ou-status-refresh fetches fresh data from every provider before printing.

What's Different from the Original

	Original (macOS)	This Fork (Linux)
Shell	Tauri menu bar app	Bun HTTP server + React SPA
Platform	macOS only	Linux (Ubuntu tested)
CLI	—	bun run status with ANSI progress bars
Antigravity	cmdline port flag	Socket-based /proc port discovery
Dashboard	—	Drag-and-drop card reordering
Plugins	Bundled, same	Bundled, same (with Linux shims)

All original OpenUsage plugins run unmodified via a node:vm sandbox with Linux host shims for HTTP (curl), SQLite, keychain, and filesystem APIs.

---

Track all your AI coding subscriptions in one place

See your usage at a glance from your menu bar. No digging through dashboards.

Download

Download the latest release (macOS, Apple Silicon & Intel)

The app auto-updates. Install once and you're set.

What It Does

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.

Supported Providers

• Amp / free tier, bonus, credits
• Antigravity / all models
• Claude / session, weekly, extra usage, local token usage (ccusage)
• Codex / session, weekly, reviews, credits, reset-credit expiry
• Copilot / premium, chat, completions
• Cursor / credits, total usage, auto usage, API usage, on-demand, CLI auth
• Factory / Droid / standard, premium tokens
• 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
• Perplexity / credits, requests
• Synthetic / API usage
• Devin / weekly quota, extra usage
• Z.ai / session, weekly, web searches

Community contributions welcome.

Want a provider that's not listed? Open an issue.

WebUI Fork Status

The local WebUI fork keeps the original Tauri app intact and adds a localhost dashboard under apps/web and apps/server.

Current WebUI provider support:

• Amp via the original plugins/amp/plugin.js adapter
• Antigravity via the original plugins/antigravity/plugin.js adapter
• Claude Code via the original plugins/claude/plugin.js adapter
• Codex via the original plugins/codex/plugin.js adapter
• Cursor via the original plugins/cursor/plugin.js adapter
• Devin via the original plugins/devin/plugin.js adapter
• Factory via the original plugins/factory/plugin.js adapter
• Grok via the original plugins/grok/plugin.js adapter
• GitHub Copilot via the original plugins/copilot/plugin.js adapter
• JetBrains AI Assistant via the original plugins/jetbrains-ai-assistant/plugin.js adapter
• Kimi via the original plugins/kimi/plugin.js adapter
• Kiro via the original plugins/kiro/plugin.js adapter
• OpenCode Go via the original plugins/opencode-go/plugin.js adapter
• Perplexity via the original plugins/perplexity/plugin.js adapter
• Synthetic via the original plugins/synthetic/plugin.js adapter
• Z.ai via the original plugins/zai/plugin.js adapter
• MiniMax via the original Token Plan remains API behavior
• Gemini CLI / Google AI Pro coding usage via ccusage
• Manual usage entries

The WebUI adapter provides Linux host shims for original plugin HTTP, SQLite, local keychain, filesystem, crypto, and formatting APIs where needed. Local keychain shim data stays under ~/.openusage-webui/plugins/<provider>/keychain.json.

See README_WEBUI.md and README_WEBUI.zh-TW.md for local WebUI setup.

Open Source, Community Driven

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.

How to Contribute

• 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.

Built Entirely with AI

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.

Sponsors

OpenUsage is supported by our sponsors. Become a sponsor to get your logo here and on openusage.ai.

Become a Sponsor

Credits

Inspired by CodexBar by @steipete. Same idea, very different approach.

License

MIT

---

Build from source

Warning: The main branch 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 while main may contain unreleased features.

Stack

...