§ 01 · Install

Install MyUsage.

A standard macOS .app delivered through GitHub Releases. There's no installer; the install is one drag.

Download.

Grab the latest MyUsage-<version>.zip from the latest release page. Each release also has a .sha256 file you can verify against:

shasum -a 256 -c MyUsage-<version>.zip.sha256

Move to /Applications.

Unzip MyUsage-<version>.zip (Finder will do this automatically when you double-click), then drag MyUsage.app into /Applications/.

First launch — handle Gatekeeper.

MyUsage is ad-hoc signed — there's no paid Apple Developer certificate yet. macOS will warn the first time you open it that the developer can't be verified. Two ways through:

"MyUsage" can't be opened because Apple cannot check it for malicious software.

This software needs to be updated. Contact the developer for more information.

Right-click the .app, choose Open, then click Open again in this dialog — macOS remembers.

Or in Terminal, strip the quarantine attribute:

xattr -cr /Applications/MyUsage.app && open /Applications/MyUsage.app

Why the warning? Apple's notarization service requires a paid Apple Developer Program membership. MyUsage is currently ad-hoc signed only. The warning is cosmetic — the binary itself is the one published in GitHub Releases, verifiable with SHA-256. Notarization is on the roadmap.

Per-provider auth.

Once running, click the menu bar icon and you'll see cards for each provider. The status of each card depends on whether that provider's auth artifact is present on this Mac:

Claude Code reads ~/.claude/.credentials.json
Codex reads ~/.codex/auth.json
Cursor reads its local state.vscdb SQLite store
Antigravity probes the running language server process

Optional — multi-device sync.

Open Settings → General, click Choose… next to "Sync folder", and pick a folder that's already syncing across your Macs (iCloud Drive's Mobile Documents folder works out of the box). Repeat the same selection on every Mac. Within one refresh cycle, each Mac's monthly cost row will show the aggregate.

Full design — including the device-ID derivation and how to forget retired peers — is in the multi-device sync doc.