Usage 0.30.16

Released: 2026-09-15

Release notes

FEATURE

Weekly quota exhaustion warnings calibrate projection logic, preventing false alarms from brief usage bursts

During intensive AI use, weekly quota exhaustion warnings no longer trigger false alarms from short bursts of activity.

Previously, it extrapolated only the burn rate from the last 30–60 minutes across the entire 7-day cycle, so intensive sessions often triggered false alarms (such as using 53.7% this week with 3 days and 1 hour until reset, yet warning "runs out in 13 hours"). Now, assess_weekly_quota() checks both rates: if the short-window rate predicts exhaustion within 1 hour, it still warns immediately; otherwise, the whole-week average rate must predict exhaustion at least 20% early (WEEKLY_AVERAGE_WARNING_RATIO) before raising a warning. The interface now displays the time predicted by the whole-week average, eliminating confusing scenarios where "runs out in 8h55m" contradicted the adjacent 5-hour session quota; rules for 5-hour session quota warnings remain unchanged.

FEATURE

Windows system tray supports UTF-8 BOM config files, resolving freezes and endless loading

On Windows, when Claude's config file ~/.claude/settings.json contains a UTF-8 BOM (byte order mark, a hidden marker added at the beginning by some editors), the system tray panel no longer gets stuck at -- and Loading. Previously, installer/setup_hook.py opened the file as plain utf-8, causing Python's parser to reject valid files with a BOM with an Unexpected UTF-8 BOM error, so the startup self-heal step failed before the refresh loop could complete. Now, both _load_settings() and the legacy migration logic use utf-8-sig, reading the file properly whether a BOM is present or not without altering parsed settings.

Original changelog

Original changelogWeekly quota exhaustion warnings calibrate projection logic, preventing false alarms from brief usage bursts
**The weekly quota warning no longer fires from a short burst of use, and the time it shows now matches the reason it fired** ([#138](https://github.com/aqua5230/usage/pull/138)). It used to extrapolate only the last 30–60 minutes of burn rate onto the 7-day window, so a dense working session alone could trigger a false alarm (e.g. 53.7% used, 3 days 1 hour to reset, warned "runs out in 13 hours"). `assess_weekly_quota()` now checks both rates: the short window still warns immediately if it alone predicts exhaustion within an hour, but otherwise the whole-week average must predict exhaustion at least 20% of the reset window early (`WEEKLY_AVERAGE_WARNING_RATIO`) before it warns — and displays that average's time instead of the short window's, which previously could show a number like "runs out in 8h55m" next to a warning actually driven by a slower week-long trend, contradicting the separate 5-hour session quota shown beside it. Session-quota warnings are unchanged.
Original changelogWindows system tray supports UTF-8 BOM config files, resolving freezes and endless loading
**The Windows tray panel could stay stuck at `--` and Loading forever when `~/.claude/settings.json` had a UTF-8 BOM.** `installer/setup_hook.py` opened the file as plain `utf-8`, and Python's JSON decoder rejects an otherwise-valid file that starts with a BOM with `Unexpected UTF-8 BOM`, so the startup self-heal step failed before the refresh loop ever completed. Both readers (`_load_settings()` and the legacy-usage migration) now open the file as `utf-8-sig`, which accepts the file with or without a BOM and does not change the parsed settings.