v1.4.4

Fixes

• Stop duplicate usage-limit notifications. Alerts (e.g. "25% of your limit remaining") could re-fire on nearly every poll, flooding Notification Center with the same banner. The de-duplication window signature was derived from a full-precision reset timestamp, so a transient parse-miss or a one-minute jitter in the CLI's reported reset time re-armed every threshold. The signature is now hour-bucketed and tolerant of a single unparseable poll, so each threshold notifies exactly once per quota window. Covered by new regression tests.

Full Changelog: v1.4.3...v1.4.4

v1.4.3

Fixes

Menu panel and notifications still said "per model" instead of the model name

v1.4.2 fixed the parser and the floating widget so the per-model weekly quota (now Fable, previously Sonnet) is tracked again instead of silently dropped. But the main menu bar panel and usage-alert notifications still used a static generic label ("Current Week (per model)") instead of the actual model name — only the compact floating/desktop widgets showed "Fable" correctly.

Both surfaces now read the real model name from the CLI output, so the menu panel shows "Current Week (Fable)" and alerts are labeled correctly too — no more mismatch between the widget and the dropdown panel.

Install

```
brew upgrade --cask claudemon
```

v1.4.2

Fixes

Per-model weekly quota tracking broken by the Fable rollout

Anthropic renamed the /usage CLI's per-model weekly limit line from Current week (Sonnet only) to Current week (Fable) after adding the Fable model. Claudemon's parser only recognized lines containing the literal word "sonnet", so the renamed line silently fell into the "all models" bucket and was dropped — the per-model bar (and the floating widget's "Sonnet" row) went dark and stayed at 0%.

Claudemon now classifies any Current week (<model>) line as the per-model metric, regardless of which model name Anthropic puts there, and reads the model name straight from the label for display. Future model renames will no longer require an app update.

Install

```
brew upgrade --cask claudemon
```

v1.4.1

Fixes

System widget sync

The Notification Center / desktop widget no longer shows stale usage frozen at install time. The App Group container is now resolved to a single canonical team-prefixed ID for both the app (writer) and the widget (reader), eliminating the divergence that left the widget reading an old cache. Widget reloads were also broadened — the app now refreshes the widget on its stale-render and prime-from-cache paths and nudges all timelines on launch.

Small widget UI

The small (systemSmall) widget now fills its canvas: a geometry-driven ring that scales to the available space with proportional fonts and stroke, instead of a fixed small ring clustered in the center with empty edges.

⚠️ One-time step after updating

A macOS app update does not relaunch the embedded widget extension automatically. After upgrading, remove the Claudemon widget and re-add it (or reboot) so the new extension takes over — otherwise the old frozen widget process keeps running.

Install

```
brew upgrade --cask claudemon
```

v1.4.0

Menu bar style options + a tidier panel

Make Claudemon's menu-bar footprint as small as you like.

Menu bar style

Choose what the menu-bar item shows (Settings → ⚙︎ → Menu bar style):

• Icon + Text (default) — gauge icon + current session percent (e.g. ◐ 42%)
• Text only — just the percent (42%), the most compact way to keep the number
• Icon only — just the gauge icon

Your choice is remembered across launches.

Tidier panel

The panel now opens clean — just your usage and the Refresh/Quit actions. A new ⚙︎ gear in the panel header reveals (or hides) the settings: Menu bar style, Floating widget, Launch at login, and Usage alerts. Collapsed by default.

Note

A menu-bar font-size control and a colored icon were explored but left out — SwiftUI's MenuBarExtra can't honor custom font sizes or colored labels. The in-panel bars and the floating/desktop widgets keep their existing green/yellow/red coloring.

Install

• Homebrew: brew upgrade --cask claudemon (the cask bumps to 1.4.0 shortly after release)
• Direct: download Claudemon.dmg below, drag to Applications.

Requires macOS 14+ and the Claude Code CLI signed in to your own subscription.

v1.3.1

Fixes the "Waiting for usage data…" hang on launch-at-login

If Claudemon was set to launch at login, it could get stuck forever showing "Waiting for usage data…" and never display your usage.

Root cause: when started by macOS at login, the app spawned the claude CLI without the USER environment variable, which makes claude /usage return an empty body — and the app treated that empty result as "no new data yet" indefinitely.

Fix:

• The claude subprocess is now always given USER/LOGNAME, so it returns real usage regardless of how the app was launched.
• Defense-in-depth: a cold start that keeps getting empty output now surfaces a clear, recoverable error (with a Refresh hint) instead of hanging silently.

No action needed beyond updating. Launch-at-login users get the biggest benefit.

Install

• Homebrew: brew upgrade --cask claudemon (bumps to 1.3.1 shortly after release)
• Direct: download Claudemon.dmg below, drag to Applications.

Requires macOS 14+ and the Claude Code CLI signed in to your own subscription.

v1.3.0

Desktop / system widget now works

You can now use Claudemon as a native macOS desktop widget (Notification Center → Edit Widgets → Claude Usage, available in small and medium sizes) — a great alternative for anyone who doesn't want the floating widget.

What changed

• Fixed the App Group data bridge so the bundled WidgetKit system widget actually shows your live usage instead of an empty "Open Claudemon" placeholder. The non-sandboxed app now resolves the team-prefixed App Group container, and the app (writer) + widget (reader) converge on the same shared cache.
• Added a hint in the menu panel pointing to the Notification Center widget.
• Internal: ordered App Group container resolver + diagnostic logging.

The floating widget and menu bar are unchanged.

Install

• Homebrew: brew install --cask ardabalkandev/tap/claudemon (updates to 1.3.0 shortly after release)
• Direct: download Claudemon.dmg below, drag to Applications.

Requires macOS 14+ and the Claude Code CLI signed in to your own subscription.

v1.2.0

Smaller mini floating widget — the double-click mini view is now noticeably more compact (88×88 panel, smaller session ring) so it stays out of the way as a glanceable indicator. Double-click again to return to the full view.

Includes the compact floating widget, in-app Check for Updates, and automated Homebrew cask bumping from prior releases.

v1.1.3

Compact floating widget — double-click the floating widget to toggle a mini session-only view, double-click again to return.

In-app Check for Updates — notifies you when a newer release is out, with a copyable brew upgrade command.

Automated Homebrew cask bumping on release.

Claudemon v1.1.2

What's fixed

⚡ Faster startup — no more long "Waiting for usage data…"

The app now primes the menu bar from its last-saved usage on launch, so your numbers appear instantly instead of waiting for the first claude CLI read. A first read without fresh limits no longer wipes the display back to a blank placeholder. Freshness is tracked from the actual capture time, so the "· stale" hint still shows when cached data is genuinely old.

🎚️ Settings rows aligned

"Floating widget", "Launch at login", and "Usage alerts" are now flush-left with the section headers, with their switches pinned to the right edge — consistent across all rows. Each switch also gets a proper VoiceOver label.

---

Install: open the DMG and drag Claudemon to Applications. Signed with Developer ID and notarized by Apple.

🤖 Generated with Claude Code