Skip to content

About

Every AI coding subscription you pay for, on one panel.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

187 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UsageDeck logo

UsageDeck

English · 繁體中文 · 简体中文 · 日本語 · 한국어

Every AI coding subscription you pay for, on one panel.

CI status Latest release Total downloads MIT license

UsageDeck is an open-source, privacy-first desktop dashboard for Windows, Linux, and macOS. It tracks usage limits, reset times, token history, and estimated spend across 13 AI coding assistants.

It lives in your tray or menu bar and reuses credentials already stored on your machine. Everything runs locally—there is no UsageDeck-operated account or backend, analytics, or telemetry. UsageDeck does make network requests to the third-party providers you configure or authenticate so it can retrieve their usage and quota information. It also refreshes its public model-price catalogs about once a day from GitHub, models.dev, and openrouter.ai so spend estimates stay current; those requests carry no credentials or usage data, and they happen whether or not you use those services.

What it tracks

Provider Credentials What you get
Claude Code Local Multiple accounts, session and weekly limits, per-model usage, token history, spend
Codex Local Session and weekly limits, rate limit resets, credits, token history, model breakdown, spend
Command Code Local Session, weekly, and monthly limits, plus extra credits
Cursor Local Total, Auto, and API usage, credits, token history, spend
Antigravity Local Shared Gemini and Claude quota pools
Copilot Local Premium requests, extra usage, chat and completion quotas, org billing
Devin Local Daily and weekly limits, reset times, extra usage balance
Grok Local Weekly allowance, extra usage status, token history, spend
OpenCode Local Go session, weekly, and monthly quotas, plus local usage and estimated spend
OpenRouter API key Credits, balance, today, this week, this month, key limit
Z.ai API key GLM Coding Plan session, weekly, and web-search quotas
Kimi API key Kimi Code session and weekly quotas, on the domain you choose
MiniMax API key Token Plan session and weekly quotas

Local providers reuse the login your CLI or editor already created — nothing to configure. API key providers need a key you paste into Customize once; it goes straight into your operating system's credential store, not into a config file. Codex subscription limits need a ChatGPT login and will not appear in an API-key-only session.

Install

Grab the file for your platform from the latest release:

Platform File Notes
Windows _x64-setup.exe or _arm64-setup.exe x64 and ARM64
macOS _universal.dmg Universal, Developer ID signed and Apple notarized
Linux .AppImage, .deb, or .rpm x64 and ARM64, with detached GPG signatures

The app updates itself. Update payloads are cryptographically signed with the project's own updater key, which is a separate thing from operating-system package signing.

Release signatures

  • Windows: each release's notes state that release's signing status — unsigned, or Authenticode-signed when a signing backend was configured for that build. Unsigned installers can trigger Microsoft SmartScreen warnings; do not infer signing status from this README.
  • macOS: official releases are signed with an Apple Developer ID certificate and notarized by Apple when the ENABLE_MACOS_NATIVE_SIGNING repository variable is set to true. Signed releases use the bundle ID com.lamchun1110.usagedeck and are stapled. The release workflow verifies the code signature, Gatekeeper assessment, notarization ticket, and hardened runtime before publishing.
  • Linux: every .AppImage, .deb, and .rpm has a matching ASCII-armored detached signature named <file>.asc. RPM packages additionally carry an embedded OpenPGP signature from the same key, verifiable with rpmkeys --checksig on rpm 4.19 or newer (Fedora 40+, RHEL 10, openSUSE Tumbleweed). Releases also include SHA256SUMS, its GPG-signed copy SHA256SUMS.asc, and usagedeck-gpg-public.asc, the public key needed for verification.

To verify a Linux download:

gpg --import usagedeck-gpg-public.asc
gpg --verify UsageDeck.AppImage.asc UsageDeck.AppImage
# Replace the example filenames above with the exact files from the release.

Important

Check each release's notes for its Windows signing status. SmartScreen may warn for an unsigned release; do not infer signing status from this static README. On macOS, builds produced without ENABLE_MACOS_NATIVE_SIGNING are ad-hoc-signed and unnotarized; Gatekeeper will block the first launch unless you right-click → Open. Only download UsageDeck from this repository's releases page. Every release states its exact signing status in the notes.

Coming from OpenQuota?

UsageDeck began as the OpenQuota fork and is now an independent project. Your data comes with you: on first launch, UsageDeck migrates settings, usage history, the pricing cache, and Antigravity's local data from an existing OpenQuota installation automatically, and API keys saved in your system credential store are moved to UsageDeck's own entry. Nothing is deleted from the old location. Keys stored in ~/.config/openquota/{kimi,minimax,zai}.json are still read; new keys live in ~/.config/usagedeck/. OpenRouter reads its own legacy path at ~/.config/openrouter/key.json.

Living with it

  • Tray popup or floating window. Glance and dismiss, or leave the panel open on a second monitor.
  • Pin what matters. Promote any metric into the tray or macOS menu bar.
  • Used or remaining. Whichever way round you think about quota.
  • Pacing. Tells you whether today's burn rate lasts until the reset, before it doesn't.
  • History. Today, yesterday, and the trailing 30 days of tokens and estimated spend.
  • Heads-up before it hurts. Optional desktop notifications when a quota is almost out, when you are cutting it close, and when your pace says you will run out before the reset.
  • Yours to arrange. Reorder providers and metrics, hide rows, collapse sections.
  • Yours to look at. Light, dark, or system, five accent colours, a compact density, and 12- or 24-hour clocks.
  • Share a card. Copy any provider's panel as an image, ready to paste.
  • Speaks your language. English, 繁體中文, 简体中文, 日本語, and 한국어 — or whatever your system is set to.
  • Stays out of the way. Launch at login, global shortcut, follows your system theme.

Everything runs on your machine. There is no UsageDeck account or UsageDeck-operated backend, analytics, or telemetry. Provider usage refreshes communicate directly with the third-party services the user has configured or authenticated.

Code signing policy

UsageDeck is open-source software released under the MIT License. Release binaries are built from this public GitHub repository by the tag-triggered GitHub Actions release workflow. Repository maintainers review source changes, and the maintainers and release approvers configured in the project's GitHub access-control settings control whether a trusted release is approved.

Each release's notes state whether its Windows artifacts are signed. Tauri updater signatures are a separate project-controlled trust layer and are required for every release regardless of the Windows Authenticode backend.

UsageDeck has no UsageDeck-operated backend, analytics, or telemetry. It is not an offline-only application: it connects to third-party providers as needed to retrieve usage and quota information configured or authenticated by the user. This policy preserves UsageDeck's lineage and attribution to OpenQuota and OpenUsage described below. See the public Privacy Policy for the complete data-handling disclosure.

Building from source

You need Node.js 22+, pnpm 11.11.0, a stable Rust toolchain, and the Tauri 2 prerequisites for your platform.

corepack pnpm install --frozen-lockfile
corepack pnpm tauri dev

Before opening a pull request, run the full gate — formatting, lint, types, contracts, and both test suites:

corepack pnpm verify

Packaging for the current platform:

corepack pnpm build:installer             # Windows
corepack pnpm build:linux                 # Linux
corepack pnpm tauri build --bundles dmg   # macOS

Release and signing requirements live in docs/releasing.md.

Contributing

Issues and pull requests are welcome — read CONTRIBUTING.md first. Please report security problems privately, following SECURITY.md, rather than in a public issue.

Lineage

OpenUsage by Robin Ebers came first, for macOS. OpenQuota by deviffyy rebuilt the idea as a cross-platform Tauri app for Windows, Linux, and macOS. UsageDeck started as a fork of that project and grew into an independent product with its own identity, release infrastructure, and roadmap. Credit for the original design and the overwhelming majority of the early code belongs to those two projects — thank you.

License

MIT

About

Every AI coding subscription you pay for, on one panel.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages