Menu-bar app for AI coding subscription usage — one panel, progress bars, no dashboard digging.
Fork of OpenUsage by Robin Ebers. Credit the upstream project when you share or redistribute this work. This repo focuses on Linux and Windows; for the macOS desktop app, use upstream releases.
| Releases | github.com/barramee27/crossusage/releases |
| Upstream | github.com/robinebers/openusage |
| Site | crossusage.dev |
Versioning: CrossUsage uses MAJOR.MINOR.PATCH (e.g. 1.0.10). See docs/VERSIONING.md for when to bump each part. Upstream OpenUsage 0.6.x is tracked in the changelog only, not in our app version.
Pick assets from the latest release:
| Platform | Typical files |
|---|---|
| Windows | *_x64-setup.exe (installer), *_windows_amd64_onefile.exe (portable) |
| Linux | *_amd64.deb, AppImage, or RPM |
| macOS GUI | OpenUsage |
| macOS / Linux CLI | crossusage-cli_*_….tar.gz (see Install) |
Desktop packages include crossusage-cli when built with the CLI sidecar.
Linux / macOS (install.sh — same command on both)
# Linux: desktop (.deb / AppImage / RPM) + CLI when the package includes it
curl -fsSL https://raw.githubusercontent.com/barramee27/crossusage/feat/linux-windows-native-support/scripts/install.sh | bash
# macOS: CLI only (no desktop .dmg in this fork — GUI → upstream OpenUsage)
curl -fsSL https://raw.githubusercontent.com/barramee27/crossusage/feat/linux-windows-native-support/scripts/install.sh | INSTALL_MODE=cli bashWindows (PowerShell)
irm https://raw.githubusercontent.com/barramee27/crossusage/feat/linux-windows-native-support/scripts/install.ps1 | iexLinux CLI-only without a desktop package: add INSTALL_MODE=cli to the first command. Details: INSTALL.md.
- Tray panel with usage bars, badges, and refresh on a schedule you choose
- Global shortcut to show/hide the panel
- Plugin-based providers (ship updates without rebuilding core logic)
- Optional local usage history (Settings → Usage history, SQLite on disk only)
- Usage insights on the home panel (pace warnings, tightest quota, next reset, 7-day rollup when history is enabled)
- Pace burn-rate alerts for primary quota lines (Settings → Usage Alerts)
- Cursor billing usage table on provider detail (
usage-stats/ cstats parity) - History CSV export and
GET /v1/history/*on the local API (with usage history enabled) - Local HTTP API on
127.0.0.1:6736while the app runs - Optional HTTP/SOCKS proxy via
~/.crossusage/config.json
Multi-account OAuth rows: multi-account credentials.
| Provider | Docs |
|---|---|
| Amp | amp |
| Antigravity / Antigravity CLI / Antigravity IDE | antigravity · cli · ide |
| Claude | claude |
| Codex | codex |
| Copilot | copilot |
| CrofAI | crofai |
| Cursor | cursor |
| Cursor Nightly | cursor (separate install at ~/.config/Cursor Nightly on Linux) |
| DeepSeek | deepseek |
| Factory / Droid | factory |
| Fireworks AI | fireworks-ai |
| Grok | grok |
| JetBrains AI Assistant | jetbrains-ai-assistant |
| Kiro | kiro |
| Kimi Code | kimi |
| MiniMax | minimax |
| Neuralwatt | neuralwatt |
| Ollama | ollama |
| OpenCode Go | opencode-go |
| Synthetic | synthetic |
| Devin | devin |
| Z.ai | zai |
New provider? Fork issues for Linux/Windows packaging; upstream issues for core/plugin API.
Terminal UI and scripts share the same plugin engine as the desktop app.
crossusage-cli # dashboard (default)
crossusage-cli list # table
crossusage-cli probe # JSON
crossusage-cli export --format csv
crossusage-cli usage-stats --provider cursor
crossusage-cli --helpBuild from clone: cargo build -p crossusage-cli. If plugins are missing, use INSTALL_MODE=cli or set CROSSUSAGE_RESOURCES to a tree with bundled_plugins/ (see paths.rs).
Requirements: Bun, Rust, platform deps for Tauri v2.
bun install
bun run bundle:plugins
bun run tauri:dev # desktop
bun run tauri:build # release bundle — use npm script, not legacy `cargo tauri` v1cargo run -p crossusage-cli -- listApp icon source: branding/crossusage-icon-color.svg → rsvg-convert + bunx tauri icon.
Tests: bun run test · Plugins: Plugin API · Contributing: CONTRIBUTING.md
MIT — fork contributors; original OpenUsage © Robin Ebers and contributors.