MeterUsage 0.3.0-beta.20 (build 90) for macOS and Windows

MeterUsage 0.3.0-beta.20, build 90 for macOS and Windows, built from the same commit (f25f7c8).

• macOS (Apple silicon, macOS 13 or later): MeterUsage-0.3.0-beta.20-mac-arm64.zip. It's Developer ID signed, notarized and stapled.
• Windows (10/11, x64), unsigned: MeterUsage-0.3.0-beta.20-win-x64.exe is the per-user installer and supports in-app updates. MeterUsage-0.3.0-beta.20-win-x64.zip is portable and can't update itself.
• SHA256SUMS lists all three files.

What's new

• Easier-to-read reset times. Each quota's reset line names the day ("Resets today, 3:00 AM", "Resets tomorrow, 3:00 AM" or "Resets Wed, Nov 11, 11:00 PM") and stands out in bold main-text colour in every interface style (#121).
• Check for Updates… in the menu bar (macOS) and notification-area (Windows) right-click menu (#117).
• The updater accepts downloads only from tilorahdotco releases. It no longer trusts the old pekth account name (#115).

Updating. If Check for updates is on, macOS beta 5 and later, and Windows beta 13 and later, offer this update within an hour. With Install updates automatically on, it installs by itself while you aren't using MeterUsage. Otherwise, download the file for your platform and check it against SHA256SUMS. On macOS, quit MeterUsage and replace the app. On Windows, run the installer.

Windows is unsigned, so SmartScreen will warn. Choose More info → Run anyway only if the file's SHA-256 matches SHA256SUMS. In PowerShell: Get-FileHash -Algorithm SHA256 <file>. In-app updates check the GitHub-reported SHA-256 and the installer's structure. There's no signature to check (ADR 0039). The Windows build passed the release workflow on windows-latest. There's no Windows test PC, so real-machine behavior is unverified (ADR 0038).

This remains a beta.

MeterUsage 0.3.0-beta.19 (build 89) for macOS and Windows

MeterUsage 0.3.0-beta.19, build 89 for macOS and Windows, built from the same commit (5cf9afc).

• macOS (Apple silicon, macOS 13 or later): MeterUsage-0.3.0-beta.19-mac-arm64.zip. It's Developer ID signed, notarized and stapled.
• Windows (10/11, x64), unsigned: MeterUsage-0.3.0-beta.19-win-x64.exe is the per-user installer and supports in-app updates. MeterUsage-0.3.0-beta.19-win-x64.zip is portable and can't update itself.
• SHA256SUMS lists all three files.

What's new

• Per-model weekly limits on the Claude card. With Claude Desktop connected, the card shows each model's own weekly plan limit, such as Weekly · Fable on Max, after Weekly · All models, with its reset time (#114).
• The Sponsor button points at the renamed GitHub account (#113).

Updating. If Check for updates is on, macOS beta 5 and later, and Windows beta 13 and later, offer this update within an hour. With Install updates automatically on, it installs by itself while you aren't using MeterUsage. Otherwise, download the file for your platform and check it against SHA256SUMS. On macOS, quit MeterUsage and replace the app. On Windows, run the installer.

Windows is unsigned, so SmartScreen will warn. Choose More info → Run anyway only if the file's SHA-256 matches SHA256SUMS. In PowerShell: Get-FileHash -Algorithm SHA256 <file>. In-app updates check the GitHub-reported SHA-256 and the installer's structure. There's no signature to check (ADR 0039). The Windows build passed the release workflow on windows-latest. There's no Windows test PC, so real-machine behavior is unverified (ADR 0038).

This remains a beta.

MeterUsage 0.3.0-beta.18 (build 88) for macOS and Windows

MeterUsage 0.3.0-beta.18, build 88 for macOS and Windows, built from the same commit (68ff0c8).

• macOS (Apple silicon, macOS 13 or later): MeterUsage-0.3.0-beta.18-mac-arm64.zip. It's Developer ID signed, notarized and stapled.
• Windows (10/11, x64), unsigned: MeterUsage-0.3.0-beta.18-win-x64.exe is the per-user installer and supports in-app updates. MeterUsage-0.3.0-beta.18-win-x64.zip is portable and can't update itself.
• SHA256SUMS lists all three files.

What's new

• Clear reasons instead of "No usage yet" when a CLI source can't supply allowance:
  • Claude Code CLI with no companion usage file: the card says Allowance unavailable for Claude Code CLI. Add a companion usage file or connect Claude Desktop, with a How to add allowance button (#109).
  • Antigravity CLI without the agy container (Docker or Podman, the antigravity-cli:local image and its volumes): the card says Allowance unavailable for Antigravity CLI. Set up the agy container or connect Antigravity Desktop (#111).
• Claude free resets. Available "Reset for free" grants show on the Claude card with their expiry, and a live, usable reset offers Use reset (#107, ADR 0044).

Updating. If Check for updates is on, macOS beta 5 and later, and Windows beta 13 and later, offer this update within an hour. With Install updates automatically on, it installs by itself while you aren't using MeterUsage. Otherwise, download the file for your platform and check it against SHA256SUMS. On macOS, quit MeterUsage and replace the app. On Windows, run the installer.

Windows is unsigned, so SmartScreen will warn. Choose More info → Run anyway only if the file's SHA-256 matches SHA256SUMS. In PowerShell: Get-FileHash -Algorithm SHA256 <file>. In-app updates check the GitHub-reported SHA-256 and the installer's structure. There's no signature to check (ADR 0039). The Windows build passed the release workflow on windows-latest. There's no Windows test PC, so real-machine behavior is unverified (ADR 0038).

This remains a beta.

MeterUsage 0.3.0-beta.17 (build 87) for macOS and Windows

MeterUsage 0.3.0-beta.17, build 87 for macOS and Windows, built from the same commit (206384b).

• macOS (Apple silicon, macOS 13 or later): MeterUsage-0.3.0-beta.17-mac-arm64.zip. It's Developer ID signed, notarized and stapled.
• Windows (10/11, x64), unsigned: MeterUsage-0.3.0-beta.17-win-x64.exe is the per-user installer and supports in-app updates. MeterUsage-0.3.0-beta.17-win-x64.zip is portable and can't update itself.
• SHA256SUMS lists all three files.

What's new: Settings is wider instead of taller (#105, ADR 0043)

• Settings opens 1040 px wide. On smaller screens it fits the display before it appears.
• Connections and API connections show their cards in two columns.
• Appearance puts the Style grid across the page, with panel size and Theme side by side.

Updating. If Check for updates is on, macOS beta 5 and later, and Windows beta 13 and later, offer this update within an hour. With Install updates automatically on, it installs by itself while you aren't using MeterUsage. Otherwise, download the file for your platform and check it against SHA256SUMS. On macOS, quit MeterUsage and replace the app. On Windows, run the installer.

Windows is unsigned, so SmartScreen will warn. Choose More info → Run anyway only if the file's SHA-256 matches SHA256SUMS. In PowerShell: Get-FileHash -Algorithm SHA256 <file>. In-app updates check the GitHub-reported SHA-256 and the installer's structure. There's no signature to check (ADR 0039). The Windows build passed the release workflow on windows-latest. There's no Windows test PC, so real-machine behavior is unverified (ADR 0038).

This remains a beta. Native side-notch captures for the styles are still pending (ADR 0042).

MeterUsage 0.3.0-beta.16 (build 86) for macOS and Windows

MeterUsage 0.3.0-beta.16, build 86 is the first release with both macOS and Windows builds, made from the same commit (73ce30b).

• macOS (Apple silicon, macOS 13 or later): MeterUsage-0.3.0-beta.16-mac-arm64.zip, Developer ID signed, notarized and stapled.
• Windows (10/11, x64), unsigned: MeterUsage-0.3.0-beta.16-win-x64.exe (per-user installer; supports in-app updates) or MeterUsage-0.3.0-beta.16-win-x64.zip (portable; cannot update itself).
• SHA256SUMS lists all three files.

Windows users get the interface styles from macOS beta.15 for the first time, plus the fixes below.

Fixes for the interface styles in beta.15 (#103)

• The Ledger, Blueprint and Orbit side-notch cards no longer let the desktop show through, which made their text hard to read on a light desktop.
• Settings opens wider, and the Style picker fits on two rows.
• Bar charts in Ledger, Orbit, Departures and Arcade render correctly again, and a few days of history no longer show as big blocks.
• Short plan badges no longer break mid-word.

The README now shows every style.

If Check for updates is on, beta 5 and later offer this update within an hour. With Install updates automatically on (beta 11 and later), it installs by itself while you aren't using MeterUsage. Otherwise, download the ZIP, verify it against SHA256SUMS, quit MeterUsage, and replace the app, keeping a copy of the existing app and its data.

Windows is unsigned, so SmartScreen will warn. When you run the installer, Windows shows "Windows protected your PC". Choose More info → Run anyway only if the file's SHA-256 matches SHA256SUMS. Check it with Get-FileHash -Algorithm SHA256 <file> in PowerShell. In-app updates from Windows beta.13 check the GitHub-reported SHA-256 and the installer's structure. There is no signature to check, so you are trusting GitHub and this repository's release permissions (ADR 0039).

The Windows build passed the Windows release workflow on windows-latest: typecheck, the Windows test subset, packaging, smoke tests, and a silent install, update relaunch and uninstall. There is no Windows test PC, so real desktop connections, upgrades, SmartScreen and display layouts are unverified (ADR 0038).

This remains a beta. Native side-notch captures for the styles are still pending (ADR 0042).

MeterUsage 0.3.0-beta.15 (build 85)

MeterUsage 0.3.0-beta.15, build 85 is the current Electron download for Apple silicon Macs running macOS 13 or later. The ZIP is Developer ID signed, notarized and stapled.

New: interface styles (#102)

Settings → Appearance → Style reskins the usage panel, side notch and Settings. Each option shows a live preview.

• Classic: the current look. It stays the default.
• Flight Deck: amber LED tapes with a pace needle.
• Orbit: rings that track time elapsed against quota used.
• Ledger: serif figures on newsprint, or ink in Dark.
• Terminal: green phosphor with ASCII bars.
• Blueprint: quotas drawn as dimension lines.
• Departures: split-flap board with reset times.
• Arcade: quota left shown as hit points.

Styles other than Classic replace the heatmap grid with a daily strip that collapses quiet weeks into one label. Service status stays in every style.

If Check for updates is on, beta 5 and later offer this update within an hour. With Install updates automatically on (beta 11 and later), it installs by itself while you aren't using MeterUsage. Otherwise, download the ZIP, verify it against SHA256SUMS, quit MeterUsage, and replace the app, keeping a copy of the existing app and its data.

Windows remains on 0.3.0-beta.13.

This remains a beta. Native side-notch captures for the new styles are still pending (ADR 0042). See the installation guide and update channels.

MeterUsage 0.3.0-beta.13 for Windows (build 83, unsigned)

First Windows build of MeterUsage. Unsigned pre-release. macOS users: nothing changes; stay on beta 12.

This release has Windows assets only, and macOS updaters skip it. GitHub's "latest" release is unchanged.

Download (Windows 10/11, x64)

• MeterUsage-0.3.0-beta.13-win-x64.exe: per-user installer. Installs to %LOCALAPPDATA%\Programs\MeterUsage, needs no admin rights, and adds a Start menu shortcut.
• MeterUsage-0.3.0-beta.13-win-x64.zip: portable copy. It cannot update itself.
• SHA256SUMS: check with Get-FileHash -Algorithm SHA256 <file> in PowerShell.

Unsigned: SmartScreen will warn

This build has no code-signing certificate. When you run the installer, Windows SmartScreen shows "Windows protected your PC". Choose More info → Run anyway only if the file's SHA-256 matches SHA256SUMS. Your browser or antivirus may also warn.

In-app updates check the GitHub-reported SHA-256 and the installer's structure. There is no signature to check, so you are trusting GitHub and this repository's release permissions (ADR 0039).

What's included

• The same app as macOS beta 12, running in the notification area. Click the icon for the usage panel; right-click for the menu.
• Side notch, Settings, and launch at login.
• Notifications (AppUserModelID dev.meterusage.app).
• Copy card image instead of Share.
• Settings and data live in %APPDATA%\MeterUsage, with preferences in preferences.json.
• CLI providers (Codex, Claude Code, Grok, OpenCode Go, OpenRouter, Antigravity via Docker or Podman, Muse) are found in the npm global folder, .cargo\bin, .bun\bin, .local\bin and PATH. npm .cmd shims run through node.exe directly. No console windows appear.
• Desktop account connections for Claude Desktop, Grok Bot Desktop, Antigravity Desktop and Codex sign-in. These read each app's Windows-protected key through DPAPI (ADR 0040).
• Automatic updates from later Windows pre-releases, including opt-in Install updates automatically. This works only in the installed copy, not the zip.
• Headless JSON: MeterUsage.exe json > report.json. Windows prints the report only when output is redirected.

What was tested

There is no Windows test PC. A GitHub Actions windows-latest runner (Windows Server 2025) is the test machine (ADR 0038). For this exact build, the release workflow ran:

• typecheck;
• the Windows test subset, including a real DPAPI round trip, cmd.exe and npm shim handling, process-tree kill, NTFS preferences and API billing storage, Claude transcripts with Windows paths, and a full synthetic Claude Desktop connection;
• packaging;
• smoke tests: headless JSON (demo and an empty real profile), a demo GUI first launch and relaunch with the usage panel and side notch, and packaged node:sqlite;
• a silent install, the updater's /S --updated --force-run relaunch, and a silent uninstall.

Not verified yet

Please report problems. These have not been checked on a real Windows PC:

• Desktop connections against real Claude Desktop, Grok Bot Desktop or Antigravity installs and accounts. That includes their folder names, packaged (MSIX) installs, and whether Claude Desktop locks its cookie store while it runs. If Connect asks you to, quit Claude Desktop and try again.
• Codex sign-in through Windows Credential Manager.
• Real provider CLIs and accounts.
• SmartScreen and antivirus behavior.
• An in-app update between two real versions, and data being kept across it.
• Tray clicks and flyout placement with other taskbar positions, multiple monitors or high-DPI scaling.
• Notifications in the Action Center, launch at login, sleep and resume, keyboard and screen-reader use.
• Windows 10, ARM64, and domain-managed PCs. Redirected %APPDATA% outside the profile is not supported.
• API billing Use saved key is macOS-only; paste a one-time Admin key instead. Saved Grok-via-Cursor connections are macOS-only too.

Source: Windows work in #94, #96, #97 and #98, built from main with the tilorahdotco release lookup (#99).

MeterUsage 0.3.0-beta.12 (build 82)

MeterUsage 0.3.0-beta.12, build 82 is the current Electron download for Apple silicon Macs running macOS 13 or later. The ZIP is Developer ID signed, notarized and stapled.

Please update to this beta. It's a bridge release ahead of moving the repository from pekth/meterusage to the tilorahdotco organization (#93).

• After the move, GitHub reports update downloads under tilorahdotco/meterusage. Betas 1–11 accept downloads only from pekth/meterusage, so they would stop finding updates.
• Beta 12 accepts downloads from either owner, and no other, so updates keep working after the move.
• Nothing else changes.

If Check for updates is on, beta 5 and later offer this update within an hour. With Install updates automatically on (beta 11), it installs by itself while you aren't using MeterUsage. Otherwise, download the ZIP, verify it against SHA256SUMS, quit MeterUsage, and replace the app, keeping a copy of the existing app and its data.

This remains a beta. The acceptance gaps listed for beta.7 are unchanged. See the installation guide and update channels.

MeterUsage 0.3.0-beta.11 (build 81)

MeterUsage 0.3.0-beta.11, build 81 adds opt-in automatic updates for Apple silicon Macs running macOS 13 or later.

In Settings > General, enable Install updates automatically to install newer verified releases while MeterUsage is not in use, then relaunch. The setting is off by default. Open windows, the expanded side notch, confirmation dialogs, sign-in and API billing fetches defer installation. Turning the setting off or dismissing the release during download prevents installation. Manual installation remains available.

This release also fixes valid framework links being rejected when macOS exposes the temporary directory through an alias. The distribution ZIP omits metadata entries that the updater rejects.

Install beta.11 manually once if an older beta cannot complete the update. Download the ZIP and verify it against SHA256SUMS, quit MeterUsage, and keep the existing app and saved data before replacing it. Then enable automatic updates for future releases.

This remains a beta. Source validation passed typecheck, 902 synthetic tests and production build; hosted CI also covered retained Swift source. Native automatic replacement and relaunch remain unverified. See the beta guide for acceptance gaps.

MeterUsage 0.3.0-beta.10 (build 80)

MeterUsage 0.3.0-beta.10, build 80 is the current Electron download for Apple silicon Macs running macOS 13 or later. The ZIP is Developer ID signed, notarized and stapled.

What's new since beta.9:

• OpenAI API balance (#88): the OpenAI API card now shows the dollars left next to spend this month.
  • MeterUsage first tries OpenAI's unofficial credit grants report with the same Admin key.
  • If that report gives no balance, enter Prepaid credit (USD) and Added on (UTC date) under Settings → API connections → OpenAI API, then click Fetch billing. The card then shows an estimate: the prepaid amount minus spend since that date.
  • A balance failure never stops the spend fetch.
  • In one test with an organization Admin key, the credit grants report gave no balance, so you may need the estimate.
• Side notch (#85): provider marks are centered on whole-pixel frames inside their quota rings.

Download the ZIP and verify it against SHA256SUMS. Beta 5 and later check hourly when Check for updates is enabled and offer Install update in the usage panel. Beta 4 and earlier need a manual install. Quit MeterUsage and keep the existing app and saved data before replacing it.

This remains a beta. The acceptance gaps listed for beta.7 are unchanged. See the installation guide, API billing guide and stable acceptance checklist.