wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About
  • What is WinGet?

© 2026 winget.ragerworks.com

Loading...
  1. Go back
  2. Packages
  3. usagestat-alpha
usagestat-alpha logo

usagestat-alpha Hashim Karim

Install usagestat-alpha with WinGet

winget install --id=HashimKarim.UsageStat.Alpha -e

usagestat-alpha is a scriptable CLI tool designed to track AI provider quotas, token usage, and costs through a local dashboard and HTTP API. It enables users to monitor and analyze consumption patterns across multiple AI services.

Key Features:

  • Use JavaScript plugins to gather detailed statistics from over 100 AI providers including Claude, OpenAI, Azure, Deepseek, and more.
  • Visualize data in real time via an interactive local dashboard with optional background daemon support.
  • Export metrics as JSON or CSV for custom reporting and integration.
  • Track usage patterns across multiple accounts and projects with granular insights into token consumption.
  • Connect to T3 Code through a built-in CLIProxyAPI bridge for enhanced workflow automation.

Target Audience and Benefits: Ideal for developers, data analysts, and AI researchers who need to manage costs and optimize resource allocation. The tool provides practical insights into usage patterns, helping users stay within budget while improving collaboration through smooth integration with existing workflows.

The application is available via the Windows Package Manager, making it easy to install or deploy using the winget command line.

README

usagestat

Track AI provider quotas, token usage, and costs through a scriptable CLI, a local dashboard, and an HTTP API.

v2.0.0-alpha.4 backend preview Latest release AUR: usagestat-bin Homebrew: hashimkarim/tap/usagestat Fedora COPR: hashimkarim/usagestat Ubuntu PPA: hashimkarim/usagestat MIT license

  • Probe provider accounts through JavaScript plugins and export JSON or CSV.
  • Keep usage available in a local dashboard with an optional background daemon.
  • Connect to T3 Code → Usage → Limits through the built-in CLIProxyAPI bridge.
  • Install both usagestat and usagestatd, plus bundled provider plugins, from your preferred package channel.

Install

The stable backend is v2.0.2 for Linux x64/ARM64 (glibc 2.39+). Its release qualification record tracks publication and checks; package feeds can lag the GitHub release. It updates provider compatibility, Codex accounting and OpenCode 2 storage, and adds three opt-in providers with dashboard setup guidance. Independent dashboard settings and RPM service updates remain available. /v1/providers, /v1/usage and optional SDK run ingestion keep their existing contracts. AgenticDriver consumers should read the migration notes before configuring capture or account quotas.

Try v2.0.0-alpha.4 on Windows, macOS or Linux. The unsigned backend alpha includes native archives and a Windows per-user installer. Native bar frontends, desktop acceptance and signing remain pending. Stable package-manager instructions follow below.

Separate alpha packages and installation instructions are available through Fedora COPR, the Ubuntu PPA, AUR, Homebrew (including macOS), Scoop and npm. Chocolatey and WinGet await upstream review; all WinGet automated checks passed. The linked guide tracks each channel's actual availability.

npm alpha package Fedora alpha package AUR alpha package Ubuntu alpha PPA package Homebrew alpha package Scoop alpha package

Choose a package manager already available on your system. Published packages and stable release downloads target Linux; the stable Homebrew formula is also Linux-only. See the v2.0.2 publication record for current versions and feed publication status.

ChannelPublished OS / CPU supportPackage
npmLinux with glibc 2.39+ · x86-64, ARM64; Node 24+@hashimkarim/usagestat@2.0.2
Arch Linux / AURArch Linux · x86-64usagestat-bin — release binaries
HomebrewLinux with system glibc 2.39+ · x86-64, ARM64hashimkarim/tap/usagestat
Fedora COPRFedora 43, 44, 45, Rawhide · x86-64usagestat
Ubuntu PPAUbuntu 24.04 LTS (Noble) · amd64usagestat
GitHub ReleasesLinux with glibc 2.39+ · x86-64, ARM64CLI + daemon + plugins in .tar.gz archives

Arch Linux

With an existing AUR helper:

yay -S usagestat-bin

Helper-free installation and PKGBUILD review.

Homebrew on Linux

With Homebrew installed:

brew install hashimkarim/tap/usagestat

The release binaries require system glibc 2.39+ (for example, Ubuntu 24.04). For older systems, use a source build.

If Homebrew asks for trust, review and approve this formula. See the formula-scoped trust instructions.

Fedora

sudo dnf install dnf5-plugins
sudo dnf copr enable hashimkarim/usagestat
sudo dnf install usagestat

Ubuntu 24.04

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:hashimkarim/usagestat
sudo apt update
sudo apt install usagestat

For direct downloads, source builds, upgrades, and removal, see the installation guide.

First run

usagestat --version
usagestat list
usagestat config validate

You should see the installed version, discovered providers, and configuration validation results. Provider access is separate from installation: sign into its supported CLI/app or configure its credentials before probing. For example:

usagestat usage claude
usagestat --json usage claude

To include a provider in regular polling, add it to ~/.config/usagestat/config.toml (or the corresponding XDG config directory):

[[providers]]
id = "claude"
enabled = true

On Linux with a systemd user session, start the dashboard and enable startup at login:

usagestat daemon enable
usagestat daemon status
usagestat dashboard

The dashboard is at . Use usagestat dashboard --url to print its link over SSH. Without systemd, run usagestatd in a terminal and open that URL while it is running. CLI probes work without starting the daemon.

Connect T3 Code

usagestat daemon t3 auto
usagestat daemon key

With the daemon running, add http://127.0.0.1:6736 as a CLIProxyAPI hub in T3 Code and paste the printed management key. T3 mode is remembered across daemon stops and restarts. usagestat daemon t3 off disables the bridge; usagestat daemon disable stops the daemon and turns off autostart. See the T3 Code setup guide for supported quotas and details.

Providers and configuration

Plugins are discovered from:

  1. USAGESTAT_PLUGIN_DIR
  2. ~/.config/usagestat/plugins
  3. Installed share/usagestat/plugins and lib/usagestat/plugins under the binary prefix
  4. ./plugins

The source tree bundles 100 providers:

  • abacus-ai, aiand, alibaba, alibaba-token-plan, amp, antigravity, antigravity-cli
  • antigravity-ide, augment, aws-bedrock, azure-openai, chutes, claude, clawrouter
  • clinepass, codebuddy, codebuff, codex, command-code, copilot, crof
  • crofai, cursor, cursor-nightly, deepgram, deepinfra, deepseek, devin
  • doubao, droid, elevenlabs, factory, fireworks-ai, gemini, grok
  • groqcloud, ibmbob, jetbrains-ai-assistant, kilo, kimi, kimi-k2, kiro
  • litellm, llm-proxy, longcat, manus, mimo, minimax, mistral
  • moonshot, nanogpt, neuralwatt, notion, ollama, openai-api, opencode
  • opencode-go, openrouter, perplexity, poe, qoder, qwencloud, sakana
  • stepfun, sub2api, synthetic, t3chat, venice, vertex-ai, warp
  • wayfinder, windsurf, xai, zai, zed, zenmux, zoommate
  • aixy, atlascloud, bifrost, coderabbit, devpass, gemini-apps, gitkraken
  • helmcode, huggingface, hyper, llmman, muse, nous, pi, raycast
  • replicate, typesafe, v0, vercel, xkiro
  • lithosai, museai, workbuddy

The released v2.0.0 and v2.0.1 packages contain 97 providers. v2.0.2 adds three opt-in web providers: Muse (muse.ai, separate from Muse Code), LithosAI and WorkBuddy. These and the 20 providers added in v2.0.0 are disabled by default; enable only the ones you use. See the provider compatibility reference for supported data sources and validation coverage.

Configure the new providers under dashboard Settings → Collection. Each uses its own saved session cookie header. LithosAI requires both __Host-console_session and __Host-console_csrf from the same console session; the native host attaches the CSRF header only on its permitted console routes. WorkBuddy also requires the full Browser User-Agent from the browser that supplied the cookies, exposed under its provider-specific settings. Automatic browser import and WorkBuddy desktop credential decryption are not implemented. The new paths are covered by synthetic fixtures; live credentials remain unqualified. TypeSafe's Cloudflare protection remains a limitation, reported as an unavailable measurement rather than an expired login or zero usage.

OpenCode Go reads the current credential table in a selected OpenCode 2 database and deduplicates migrated history. A present empty table means logout; its old imported auth.json is not reused. Set databasePath for a preview channel or additional source to keep credentials and history on that selected database.

usagestat --json list includes provider-owned UI metadata. Icon paths are resolved to absolute SVG paths; icon.path is the monochrome/default icon and icon.colorPath is present only when a separate color SVG is available. Shared artwork comes from @agenticdriver/provider-icons, pinned and vendored under plugins/_provider-icons; custom provider icons still take precedence. Run node tools/provider-icons.mjs --check to verify the selected assets.

Configuration paths and advanced example

Default config path:

~/.config/usagestat/config.toml

Default cache path:

~/.local/share/usagestat/snapshots.json

An advanced example with separate accounts and sources (mock requires the dev-only plugins described below):

refreshSec = 60
pluginDirs = ["/path/to/more/plugins"]

[[providers]]
id = "mock"
enabled = true

[[providers]]
id = "claude"
instanceId = "claude-web"
displayName = "Claude Web"
enabled = true
source = "web"
cookieHeader = "sessionKey=..."

[[providers]]
id = "openai-api"
instanceId = "openai-api-eu"
displayName = "OpenAI API EU"
enabled = true
source = "api"
apiKey = "sk-..."
region = "eu"
workspaceId = "workspace-123"

[[providers]]
id = "custom"
instanceId = "local-script"
displayName = "Local Usage Script"
enabled = true
source = "custom"
customCommand = "/path/to/usage-script --json"

Both binaries accept overrides:

cargo run -p usagestat-cli -- --config ./config.toml --plugin-dir ./plugins list
cargo run -p usagestat-daemon -- --config ./config.toml --refresh-sec 30

Dashboard and history

The dedicated History tab is included in v2.0.0. History adds provider/date filters, daily/weekly/monthly charts, previous-period comparisons, and CSV export of saved daily reports. Quota-only providers retain their snapshot charts. See CLI and dashboard documentation.

The dashboard also has Used/Remaining quotas, month-to-date and all-time history ranges, daily ledger rows, partial/unpriced cost indicators, and portable display preferences. Saved daily usage is available through JSON cost reports and /v1/history/daily// (month, all, or a day count). /metrics exports provider health and quota gauges for Prometheus without credential or account labels. See history accounting for source precedence, model estimates, cache savings, and pricing coverage.

The v2.0.1 dashboard's Settings tab separates Display preferences from shared backend Collection setup. Display includes visibility, names, ordering, trackers, provider logo variants, monochrome/colour, themes, thresholds and layout. Collection configures polling, provider sources and write-only credentials after unlocking with the private local setup key. Display stays independent of UsageStat Bar. Charts offer hover, focus and tap details for recorded quotas, tokens and costs. Upgrade the daemon to v2.0.1 to receive these settings; existing v2.0.0 binaries and tags are unchanged. See dashboard settings and automatic service updates.

Development

Build and install a separate dev profile with a current stable Rust toolchain and the source-build prerequisites:

scripts/install-dev.sh
usagestat-dev --version

usagestat-dev daemon enable uses the separate usagestat-dev.service and dev config/data directories.

This starts from CrossUsage's architecture, but uses separate project names and contracts:

  • usagestat-core: shared models, config, paths, cache.
  • usagestat-plugins: JavaScript provider plugin loader/runtime.
  • usagestat-cli: scriptable CLI.
  • usagestat-daemon: local polling daemon with an HTTP API.

Run commands directly from the checkout

cargo run -p usagestat-cli -- list
cargo run -p usagestat-cli -- --plugin-dir templates/dev-providers --json usage mock
cargo run -p usagestat-cli -- usage --provider claude --save
cargo run -p usagestat-cli -- status claude codex
cargo run -p usagestat-cli -- export --format csv
cargo run -p usagestat-cli -- auth import-cookies --provider codex --format json
cargo run -p usagestat-cli -- config validate
cargo run -p usagestat-cli -- cache clear --history
cargo run -p usagestat-cli -- plugin validate
cargo run -p usagestat-daemon
curl http://127.0.0.1:6736/v1/usage

HTTP API

Endpoints in the source checkout:

  • GET /health
  • GET /v1/providers
  • GET /v1/usage
  • GET /v1/usage/:providerId
  • GET /v0/management/quota-scheduler/status (opt-in, management key required)

See CLI documentation for usage/history exports and daemon controls.

Plugin host API

Provider plugins export globalThis.__usagestat_plugin.probe(ctx).

A copyable plugin template lives at templates/provider-plugin. It includes examples for api, oauth, local, cli, and web source modes. Dev-only example providers live under templates/dev-providers and are not loaded or packaged as production providers.

Available context:

  • ctx.nowIso
  • ctx.sourceMode
  • ctx.app.version
  • ctx.app.platform
  • ctx.app.appDataDir
  • ctx.app.pluginDataDir
  • ctx.host.log.info|warn|error(message)
  • ctx.host.env.get(name) for allowlisted variables
  • ctx.host.fs.homeDir
  • ctx.host.fs.exists(path)
  • ctx.host.fs.readText(path)
  • ctx.host.fs.listDir(path)
  • ctx.host.http.request({ url, method, headers, bodyText, timeoutMs })
  • ctx.host.command.run({ program, args, timeoutMs }) for allowlisted commands

Host HTTP responses use:

{
  "status": 200,
  "headers": {},
  "bodyText": "{}"
}

Documentation and contributing

  • Installation, upgrades, and removal
  • CLI reference and troubleshooting
  • T3 Code integration
  • GNOME extension integration
  • Release publishing and platform maintenance
  • Provider plugin template
  • Changelog

For changes, run cargo test --locked --workspace. Report bugs or propose changes through GitHub issues.

License

MIT. This project builds on CrossUsage's architecture. Adapted provider code and assets retain their upstream notices.

Versions
2.0.0-alpha.3
Website
github.com
License
Last updated
10/21/2026
Download latest version