Skip to content

v1.5.0 — Cursor usage and a clash check that runs anywhere

Choose a tag to compare

@btsouth btsouth released this 19 Sep 23:07
· 46 commits to main since this release

AI Usage Dashboard v1.5.0

This release adds Cursor — cloud usage events and a billing-cycle quota meter — and fixes the installer's built-in-widget check, which could only pass on the machine it was written on.

🟣 Cursor

Cursor is the first source here that cannot be rebuilt from local files, so it is read from Cursor's own usage events, per model:

  • Token history — every event's input, output, and cache-read tokens, priced at list price
  • A billing-cycle quota meter with its reset date, read through the session the Cursor desktop app already stores locally
  • Free events still count — an event that carries no tokens is kept as a turn rather than dropped as empty

The session token is read from Cursor's local store and is never copied, logged, or sent anywhere but Cursor. The endpoint is undocumented and can move without notice; when a call fails, the previous snapshot stays in place with its error and nothing else in the dashboard is affected.

Event costs are list prices and plan discounts are not applied per event, so the quota card's billed total is the figure to trust where the two disagree.

Cursor support arrived as a community pull request from @hilather — the collector, the paginated walk with resume, the quota mapping, the pricing, and the tests are his work. Thank you.

🛠 Also in this release

  • The installer's built-in-widget check read /usr/share/omarchy directly — a path that exists on a development machine and nowhere else — so it passed locally and went red the moment it ran anywhere else. It now follows the OMARCHY_PATH convention refresh.sh already uses, and its test stages a fixture manifest instead of reaching for the host's.
  • The README's opening paragraph now names reset notifications and the live limit meters, and says that Fireworks starts off.

📦 Install

curl -fsSL https://raw.githubusercontent.com/btsouth/omarchy-usage-dashboard/main/install.sh | bash -s -- --with-plugin

Updating an existing install: git pull --ff-only && python3 install.py --with-plugin — history and preferences are preserved.

Full changelog: v1.4.0 → v1.5.0