v0.6.0 — Insights & retention

Insights & retention

• History: 7D / 30D / All range chips.
• Overview: LAST 7/30 DAYS spend readout; cross-account top-models table with share bars.
• CSV export (Settings → Data): snapshot history + per-model rows via the share sheet.
• Home-screen widget: NEXT WALL gauge — most urgent pool, % used, reset time; refreshed after every sync (foreground and background).

Fixes

• OpenRouter: /activity is management-key-only — regular sk-or-v1 keys no longer fail the whole sync and keep the key-quota window. Token usage now shown next to dollars: in/out/request totals on every account and per-model in/out splits. Management keys get the full 30-day per-model token history.

v0.5.0 — OpenRouter + OpenAI

New providers

• OpenRouter: prepaid balance as a Credits gauge (management key), per-key quota window, 30-day per-model usage history with reasoning tokens. Regular sk-or-v1 keys work with graceful degradation (key quota only).
• OpenAI: organization spend + per-model tokens via the admin Usage API (sk-admin- key required — project keys cannot read usage). Monthly cost as an uncapped window, cursor-paginated, per-SKU cost breakdown.

Also

• Add-account flow now shows per-provider key placeholders, instructions, and a non-blocking warning when a key doesn't match the expected shape.
• Provider registry is metadata-driven (id, name, icon, key hint, advisory pattern) — future providers are a single class + icon.

API shapes verified against official docs on release day. 29 tests green.

APK: sideload ai-usage-monitor.apk.

v0.4.0 — Account health, settings, background sync

Highlights

• Account health: failed syncs are no longer invisible. Each account card shows a SYNC FAILED state with the actual error and an Update key action that verifies and saves a new credential in place.
• Settings screen (gear icon, top right): sync interval (off/5/15/30/60m) now actually configurable, limit-alert notifications toggle, about card.
• Real background sync on Android: periodic WorkManager task refreshes accounts and fires limit alerts even when the app is closed (15-minute OS floor; respects your interval setting).
• CI: analyze + hermetic test suite on every push; signed APK built automatically on version tags.
• minSdk raised to Android 6.0 (23) for background work support.

For developers: providers now accept an injected HTTP client; 9 provider fixture tests + db migration test added (21 total).

APK: sideload ai-usage-monitor.apk (signed release build).

v0.3.0 — Burn-rate outlooks, account detail, auto-sync

Highlights

• Burn-rate outlooks: the hero gauge now projects whether each budget pool survives until its reset ("runs out ~2d before reset"), from a trailing 3-day pace blended with today's partial spend.
• Account detail screen: tap any account for every limit window, spend trend, token split, and expandable snapshot history.
• Auto-sync: configurable background refresh interval (off/5/15/30/60 min), persisted per device.
• Limit notifications (Android): local notification when a pool runs out — once per reset, no spam.
• Honest daily-spend chart: per-account day-over-day deltas of period totals, clamped at resets — no more plotting account balances as daily spend.
• Pull-to-refresh now works with mouse drag on desktop; Space Grotesk + JetBrains Mono typography.

Fixes: daily pace no longer reports $0/day from mixed-account cumulative data; protobuf int64 string coercion hardened.

APK: sideload ai-usage-monitor.apk (signed release build).

UsageLedger v0.2.3

What's new

Usage details

• Collapsible model breakdown on each account card — cost, tokens, and % of total spend
• Cursor models split into Auto vs API buckets (refresh accounts to populate)

API keys

• Keys shown in plain text on the Accounts tab
• Selectable + copy button — private single-user app, no masking

Branding

• New UsageLedger launcher icon on Android

Repo

• Flutter agent skills under flutter/.cursor/skills/
• Mobile UI prototypes in docs/ui-examples/

Install

Download ai-usage-monitor.apk and sideload. Installs over previous builds with the same signing key.

UsageLedger v0.2.2

What's new

Cursor auth

• Connect with a User API key (crsr_…) from cursor.com/dashboard instead of a short-lived access token
• Keys are stored on-device; the app exchanges them for session tokens when syncing

UI / UX

• Real Command Code and Cursor logos on account cards and the add-account sheet
• Shared screen headers, sync button on Overview, clearer empty states with direct actions
• Improved add-account form (labeled fields, visible error banners, 48dp touch targets)
• Navigation bar polish and more consistent spacing/typography

Install

Download ai-usage-monitor.apk and sideload on Android. Installs over v0.2.0 / v0.2.1 with the same signing key.

UsageLedger v0.2.1

Fixes

• Add account button works again — the bottom sheet failed to open because it was called from a context above MaterialApp (no Navigator). Shell state now lives inside MaterialApp.

Install

Download ai-usage-monitor.apk and sideload on Android (same signing key as v0.2.0 — installs over the previous build).

UsageLedger v0.2.0

What's new

• Accounts First light mobile UI — refreshed Home, Accounts, and History screens with a clean light theme tuned for phones.
• Bottom-sheet add account — add Command Code or Cursor credentials without leaving the current screen.
• Cursor usage windows — one included $70 budget pool; Auto and API shown as shares of that pool, with extra/bonus spend tracked separately (not three independent $70 bars).
• Command Code billing periods — weekly pool, monthly period spend plus remaining credits, and idle 5-hour burst shown as ready; relative reset times on all windows.

Install

Download ai-usage-monitor.apk below and sideload on Android 8+ (Settings → allow install from unknown sources for your file manager or browser).

UsageLedger v0.1.0 — First release

Track your AI spend across Command Code and Cursor — multi-account, straight from your phone.

Install

Download ai-usage-monitor.apk, open it on your phone, and allow "Install unknown apps" when prompted. Android 8+.

Features

• Command Code: requests, tokens (in/out), cost, 5-hour / weekly / monthly limit windows
• Cursor: plan spend, included-usage splits (Auto vs API vs total), per-model token + cache breakdowns
• Snapshots on every refresh build a cost-over-time history
• Tokens stored in the OS secure store; nothing leaves your phone

Getting tokens

• Command Code: ~/.commandcode/auth.json → apiKey (starts user_)
• Cursor: cursor-agent login on desktop, paste the token into the app