LLM Usage Status

What's New in Version 0.3.0

• Automatic updates — the app checks for a new version once a day and offers it in an alert; nothing installs until you choose Install Update. Check for Updates… is in the right-click menu, and Settings has a new Updates section.
• Claude's weekly limit gets its own headline — the Claude Code section shows the 5-hour and the 7-day limit as two headlines, each with percent left, a countdown and a bar.
• Fable allowance — on plans where Claude reports a separate Fable allowance, a smaller bar under the 7-day headline shows how much of it is left.
• Codex 5-hour headline — with Show 5-hour limit on, Codex shows the 5-hour limit as a second headline. The toggle no longer hides Claude's 5-hour meter.

See the CHANGELOG for every release.

Why This Tool Exists

Each LLM CLI reports its usage differently: some through undocumented endpoints, some only through local logs, and one has no usage API at all. Checking each one separately means digging through files or settings you cannot reach. LLM Usage Status collects what is available and shows it in a single panel summoned by a global keyboard shortcut, so current utilization, allowances, and renewal times are one keystroke away.

Features

• One panel, one section per provider — Codex, Claude Code, and Mistral Vibe. A CLI that is not installed shows "not detected"; one provider failing never breaks the other sections.
• Utilization meters and renewal countdowns per provider.
• Estimated values are always visibly labeled as estimates — the panel never presents a guess as an authoritative allowance.
• One headline per limit window: Claude Code shows its 5-hour and 7-day limits as two headlines, plus a Fable allowance bar when Claude reports one.
• Per-provider preferences in a right-click menu, including the optional Codex 5-hour headline; settings persist across restarts and update the open panel immediately.
• Refresh on open; a failed refresh retains the last successful values with a visible stale-data message and the last update time.
• Hotkey fallback: when the shortcut cannot be registered, a warning menu-bar item appears and offers Show HUD, Retry Shortcut, Settings, Check for Updates…, Help, and Quit.
• Settings window: turn each provider on or off, launch at login, a rebindable show/hide shortcut, automatic update checks, and the app's version.
• Automatic updates: a daily check, Check for Updates… in the right-click menu, and signed updates that install only after you accept them.
• A provider that is turned off is hidden from the panel and never read — no file, Keychain or network access for it.
• Shortcut names follow your keyboard layout: on a German layout a chord recorded on the key labelled Z reads "Z", not the US "Y". Function, arrow, and other special keys keep their spelled-out names.
• Built-in Help window with searchable topics, plus Send Feedback… and Leave a Tip in the right-click menu.

Screenshots

Rendered from the app with sample values.

Quick Start

Press Control-Option-Command-L anywhere to toggle the panel. Clicking anywhere else dismisses it; drag the panel to move it. Opening the panel refreshes usage. Right-click the panel for section preferences, Settings, Check for Updates…, Help, Restart, Send Feedback…, Leave a Tip, and Quit.

Settings

Open Settings from the panel's right-click menu, or press Command-Comma while the panel is showing (the app does not take Command-Comma from other apps while the panel is hidden). Command-Comma follows the keyboard layout: it is Command plus whichever key types a comma, on AZERTY too. Changes apply immediately; Escape or Command-W closes the window.

• Providers — one checkbox each for Codex, Claude Code, and Mistral Vibe, all on by default. A provider that is off has no panel section, no refresh, and no right-click items (Show 5-hour limit hides with Codex, Set Vibe Monthly Budget… with Vibe). With all three off the panel says so. Turning one on while the panel shows brings it back and refreshes it.

• Launch at login — shows the real state from macOS, including changes made in System Settings → General → Login Items. If macOS asks for approval, the window offers Open Login Items…. The option is available only when the app runs from an Applications folder; elsewhere (a build folder, Downloads, a disk image) it is disabled with the reason.

• Shortcut — click the field and press a new chord. It must include Command or Control; Command-Comma is reserved, and standard Command chords such as Command-C or Command-Space are refused. The check follows the keyboard layout: on German QWERTZ the key labelled Z is refused with Command and the key labelled Y is accepted. The ISO key next to Left Shift can be used. A chord another app already holds is refused and the previous shortcut keeps working. Reset to Default restores Control-Option-Command-L. The shortcut persists across restarts.

• Updates — Check for updates automatically (on by default) runs one check a day. Check for Updates… checks now, and the line below says when the last check ran (or "Never checked").

• About — name, version and build number.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗