Skip to content

v1.4.0 — one widget, reset notifications, Command Code sessions

Choose a tag to compare

@btsouth btsouth released this 19 Sep 21:41
· 51 commits to main since this release

AI Usage Dashboard v1.4.0

This release makes the packaged widget the only widget — and the complete one — adds reset notifications, and counts work done through the Command Code CLI.

🔀 The widget merge

The widget that ships with the dashboard now includes everything a private, customized clone held — rebuilt as settings anyone can set from the widget's bar.layout entry in shell.json:

  • providerOrder — walk the bar and panel in your order. Unlisted providers follow alphabetically, so a new provider never drops off the end.
  • launchCommands — right-click a provider to launch its own CLI in a terminal; unmapped providers fall back to Omarchy's agent picker.
  • extraProviders — write an upstream-format record into the usage directory and the widget shows it. Bring your own collector; the record is the whole contract.
  • alwaysShow — keep a provider on the bar before it has numbers.
  • Fireworks is back (off by default; enable it in Settings).

The installer now names any other installed model-usage widget it finds — including Omarchy's built-in Agents widget — so a second AI icon never appears by surprise.

🔔 Reset notifications

A desktop notification when a weekly or monthly limit resets, or when banked reset credits arrive (the way Codex delivers dropped resets) — with the provider's own mark on the popup.

  • Short (session) windows never notify
  • Codex and Claude are watched by default; more via --provider, never by silent opt-in
  • Overlapping refreshes serialize on a lock file, so a reset notifies exactly once

💳 CommandCode now counts Command Code sessions

The CommandCode route used to know only what the Hermes ledger recorded — work driven through the Command Code CLI never appeared, and the model list showed last night's sessions long after the day had moved on. The collector now reads Command Code's session transcripts per message, with each message's own usage, priced through the same CommandCode rate table. The provider card carries the whole account: Hermes routes, the CLI, and the agents that run through it.

🛠 Also in this release

  • The panel's --limits-only, --except, and agent ids are now forwarded to the updater instead of swallowed — opening the panel no longer runs a full scan or hits endpoints for providers you disabled
  • On machines with their own refresh orchestrator, it takes precedence; the packaged updater covers everyone else
  • Panel text renders as plain text again (12 sites restored to upstream behavior)
  • Uninstall removes a customized bar entry by id, not by exact match
  • 6 new tests (notifier filter, refresh forwarding, lock interlock, installer clash + uninstall) — 116 total, all green

📦 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.3.0 → v1.4.0