Changed

• Context-window nudge reframed around quality, and fires earlier (≥70%): the status line reminder added in 0.20.0 was framed around cost, but Claude Code (and Codex) auto-compact at ~80% and prompt caching makes resent context cheap — so the cost angle added little. What actually degrades as a conversation grows is quality: models lose the middle of long inputs well before the window fills. The nudge now triggers at 70% — ahead of the lossy automatic compaction — and suggests taking control yourself: /clear when switching tasks, or /compact to keep the focus you choose. The dollar figure was dropped.

Added

• Status line nudges /clear when the context window goes heavy (≥80%): once a Claude Code conversation fills its context window past the red zone, the status line appends a one-line reminder. Past that point every turn resends a heavy context — pricier turns and a faster rate-limit burn, both of which /clear resets. The nudge shows the context % and, when available, the session cost, in all five languages.

Fixed

• Codex 5h quota no longer goes stale on long-lived sessions: the rate-limit reader scanned Codex session files newest-date-directory first and stopped at a scan limit, which could skip the file that was actually modified most recently when a long session keeps appending to an older creation-date directory. It now sorts all visible session files by modification time, so the menu bar always reflects the newest snapshot. (#37, by @ericweichun)

Contributors

• @ericweichun

Fixed

• Hidden Claude Code section no longer leaks a setup error: Codex-only users who hid the Claude Code section still saw a "status file not found — run python3 main.py --setup" message in the popover footer, plus an "Install Hook" button. Both are Claude Code-specific and are now suppressed while the section is hidden; the footer falls back to a neutral synced status. (#36, reported by @ilss0902)

Contributors

• @ilss0902

Added

• Hide Claude Code section: a new "Hide Sections ▸" submenu in the Switch Panel menu lets you hide Claude Code and Codex independently, so Codex-only users can hide the Claude Code card from every panel theme and the Claude Code percentage from the menu bar (Codex then leads the readout). Every panel keeps its "Switch Panel" button reachable — when the Claude Code card is hidden, the button moves to the next visible card. (#35, requested by @ilss0902)

Changed

• Hiding a provider now also hides its percentage from the menu bar (previously "Hide Codex Section" only hid the popover card). With both providers hidden, the paw icon stays in the menu bar as the click target.
• Shorter settings menu: the "Automatically Check for Updates" row is gone — update checks simply stay on by default (still honored if disabled in ~/.claude/usage-preferences.json), and the two hide toggles are consolidated into the "Hide Sections ▸" submenu.

Contributors

• @ilss0902

Added

• Health-check diagnosis on every new conversation: usage now runs a background diagnosis engine against your Claude Code session logs and, when it finds meaningful waste, quietly appends a one-line reminder to the Progress Concierge's opening handoff. Say "show me" and the model reads the full snapshot (~/.claude/usage-diagnosis.json) and explains findings with specific suggestions. The reminder is suppressed for 7 days once a fingerprint is seen, re-surfaces when the diagnosis changes, and is skipped entirely when the snapshot is stale (>48 h).
• Five-rule diagnosis engine (analyzer/diagnoser.py): detects repeated file reads, polluter directories (node_modules, .venv, dist, ...), anomalous session sizes, noisy Bash output, and repeated Bash commands. Findings are ranked by estimated token waste so the most actionable finding is always surfaced first.
• Daily diagnosis snapshot (usage_diagnosis_snapshot.py): the menu-bar app refreshes ~/.claude/usage-diagnosis.json once per day in the background so the cost estimate is always fresh when you open a new conversation.

Fixed

• Anomaly-session waste estimates are no longer inflated ×ばつ: the engine previously counted the entire token total of an anomalous session as waste and priced every token at the full 3ドル/MTok input rate. Long sessions are dominated by cache reads billed at a tenth of that (0ドル.30/MTok), and the work done in the session isn't waste at all — only the excess over the project baseline is. Cost is now split by token type and scaled to the excess share (real-data result: 254ドル → 27ドル).

Fixed

• Lepidoptera panel no longer shifts when the project list is empty: the panel was vertically centered, so with no project data the cards floated to the middle of the popover and jumped when projects appeared. It now top-aligns like the other panels, with the project card absorbing the extra height, so the layout stays stable whether or not projects are listed.

Added

• New "Lepidoptera" panel theme: a cyanotype blueprint plate inspired by the Fable 5 launch — deep Prussian-blue ground with a cyan engineering grid, the Claude Code and Codex logos mounted in cyan registration frames, monospace engineering readouts, corner crop marks, and white technical line-art butterflies drawn as schematics (construction circles, centerlines, wingspan dimensions) that drift and beat their wings across the panel. Pick it from "Switch Panel". Honors prefers-reduced-motion.

Changed

• Cleaner project list on more panels: removed the redundant row separators on the Matrix, Newspaper, and Windows 95 panels — each already shows a per-project usage bar, so projects are now divided by that bar alone, matching the default panel. (Panels that rely on separators instead of a usage bar are unchanged.)

Changed

• Homebrew now ships as a cask: usage is a GUI app, so it's now distributed via Homebrew's cask format — it drops usage.app straight into your Applications folder and skips the formula relocation/re-signing pass, which also fully fixes the earlier usage.app/usage.app doubled-path Errno::ENOENT install failure. Install with brew install --cask aqua5230/usage/usage; if you previously installed via the formula, run brew uninstall usage first, then reinstall. (Thanks @anatolii-maslennikov-improvado for reporting #34)
• Sharper, cleaner default panel: the default menu-bar panel now renders text with crisper font smoothing and standard font weights, shows project rankings as filled number badges (top project highlighted in green), brightens the active tab, drops the redundant row separators, and fixes the slightly clipped top edge on the project token counts.

Contributors

• @anatolii-maslennikov-improvado

Fixed

• Homebrew install no longer fails: because the release zip had a single top-level usage.app directory, Homebrew would auto-chdir into it and then fail to find the file to install, raising Errno::ENOENT ... usage.app. The formula's install path is fixed — just reinstall. (Thanks @teddy123434 for reporting #32)
• Claude Code no longer errors on startup after installing the status-line hook from the .app: installing from the packaged .app used to write the app's bundled Python — which can't run standalone outside the bundle — into the hook config, so Claude Code threw Could not find platform independent libraries on startup and the status line wouldn't show. It now always uses the system /usr/bin/python3, and any previously corrupted config is repaired automatically on next launch or re-run of setup. (Thanks @teddy123434 for reporting #32)

Contributors

• @teddy123434