UsageWidget app icon

UsageWidget

Self-hosted usage at a glance

The first beta is starting to roll out

Your AI usage limits — Codex, Claude, Grok, and more — as a private iPhone dashboard and Home Screen widget, with reset times, burn-rate forecasts, and timely alerts. Powered by your own server, not someone else's.

How it works

Three pieces, all yours. Provider credentials never leave your Linux box.

1

Collector on your server

A one-line installer sets up a small Go daemon on your Linux host. An isolated collector reads usage data from your existing CodexBar session.

2

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.

3

Glanceable on iPhone

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

Everything on one screen

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

📱

Home Screen widget

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

🔀

Multi-provider

Codex, Claude, Grok, and any provider CodexBar supports. New providers show up automatically — nothing is hard-coded.

📈

Burn-rate forecasts

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

🔔

Smart alerts

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

🕓

Honest freshness

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

🩺

Release readiness

Built-in diagnostics check server, APNs, and device end to end — including an audible alert and widget-delivery test.

Private by architecture

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

Join the waitlist

The first beta is starting to roll out. Join the waitlist to be notified when a TestFlight spot is ready for you.

Join the waitlist

Get started

On an Ubuntu 22.04/24.04 or Debian 12 host with a CodexBar session:

curl -fsSL https://usagewidget.edmundlim.systems/install.sh | sudo bash -s -- --collector-user YOUR_LOGIN

Replace YOUR_LOGIN with the Linux user that owns the CodexBar session. Then build the iOS app from the source repository and scan the setup QR the installer prints. Requires iOS 26+.