UsageWidget. Self-hosted usage at a glance

How it works

Three pieces, all yours. Provider credentials never leave your own machines.

Collector on your server

A small Go daemon runs on Linux, macOS, or Windows. Linux isolates collection. Desktop builds use a local CrossUsage CLI or the loopback limits API.

Private connection

Your iPhone talks to the server over Tailscale HTTPS with a bearer token. Only normalized display data crosses the wire, never raw provider payloads.

Glanceable on iPhone

Scan a setup QR and you are done. The app and large Home Screen widget show every rate window, its reset time, and what is about to run out.

Everything on one screen

Stop tabbing through AI services to check whether you are about to hit a limit.

Home Screen widget

Check remaining capacity across providers without opening any AI service, or even the app.

Multi-provider

Cursor, Codex, Claude, Grok, Copilot, and Gemini, collected from CrossUsage on one machine.

Burn-rate forecasts

Predicts whether you will hit 100% before the window resets, once enough history has accumulated.

Smart alerts

Threshold crossings, scheduled and early resets, credit increases. Global or per-provider rules, with quiet hours.

Honest freshness

Distinguishes collecting, current, stale, and unavailable. Cached fallback instead of pretending failed data is live.

Private by architecture

No analytics, no ads, no third-party SDKs
No developer-operated servers. You host it
Provider credentials never leave your own machines
Server URL and token stored in the iOS Keychain
Camera used only to scan your setup QR
Open source, end to end

Get started

Run from any computer and install to any Linux, macOS, or Windows SSH target:

curl -fsSL https://usagewidget.edmundlim.systems/install.sh | bash

irm https://usagewidget.edmundlim.systems/install.ps1 | iex

Run this on a laptop, not on the server. It SSHs to the machine you name, installs a GitHub release there (Linux uses server-install.sh), and prints the iPhone setup QR in this terminal. Then build the iOS app from the source repository and scan that QR. Requires iOS 26+.