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 is the Tauri app for Linux and Windows. Upstream 0.7+ is a Swift native macOS app — use upstream releases for macOS GUI. Maintainer porting notes: docs/FORK-UPSTREAM.md.
| 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://github.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://github.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
- Classic or Modern UI — pick at first run or in Settings → Appearance; same providers in both (0.7 port spec)
- 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 for all providers — add Work/personal rows per provider in Settings (API keys + OAuth); credentials encrypted at rest. See multi-account credentials.
| Provider | Docs |
|---|---|
| Amp | amp |
| Antigravity / Antigravity CLI / Antigravity IDE | antigravity · cli · ide |
| Claude | claude |
| Codex | codex |
| Command Code | command-code |
| 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 |
| OpenRouter | plugins/openrouter (API key: OPENROUTER_API_KEY) |
| Perplexity | perplexity |
| 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.