LLM Usage 1.5.0

Download the ZIP below, extract it and move LLM Usage.app to Applications.

• Requires macOS 26+ on Apple Silicon. Native ccusage is bundled; Node.js and npm are not required.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed without notarization. If macOS blocks a trusted copy, use System Settings → Privacy & Security → Open Anyway.
• SHA256SUMS.txt contains the ZIP checksum.

See installation instructions for first-launch setup. Changes in this version are listed below.

On first launch, approve the bundled calculation component and choose automatic updates, download-and-ask, or manual updates. The default is automatic, with a visible countdown before restarting. Updates verify signed metadata and archives. Ad-hoc signing and the first-install Gatekeeper instructions still apply.

What's Changed

• feat: bundle pinned ccusage and add signed app updates by @RunGuitarMan in #23

Full Changelog: v1.4.0...v1.5.0

LLM Usage 1.4.0

Download the ZIP below, extract it and move LLM Usage.app to Applications.

• Requires macOS 26+ on Apple Silicon, Node.js and ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed without notarization. If macOS blocks a trusted copy, use System Settings → Privacy & Security → Open Anyway.
• SHA256SUMS.txt contains the ZIP checksum.

See installation instructions for CLI setup. Changes in this version are listed below.

What's Changed

• feat: add private UI review and fix statistics and chat interactions by @RunGuitarMan in #22

Full Changelog: v1.3.1...v1.4.0

LLM Usage 1.3.1

Download the ZIP below and move LLM Usage.app to Applications.

• Chat usage and timing (#13): inspect request and prompt token totals, estimated costs, costliest requests, tool calls and recorded timing for Claude Code, Codex and Gemini. Shared requests and verified replay history avoid duplicate charges; missing prices and incomplete timing stay explicit.
• Unified Statistics (#16): browse the top three sessions or expand the searchable, sortable list on the same screen. Date selection, the session inspector and widget links preserve the selected session through filtering and repeated navigation.
• Reliable refresh and history: manual refresh immediately updates the refresh policy. Late responses cannot replace newer reports, yesterday stays consistent with history and widgets, and clock corrections no longer stall refresh or freeze historical totals.
• Accurate accounting and recovery: fix Claude streaming deduplication, Codex pricing tiers, per-category model attribution and validation of cached amounts. Available tariffs remain usable when their disk cache cannot be written, and damaged tariff receipts recover on the next report.
• Safer transcript loading and local upgrades: preserve valid messages around damaged JSON entries and full SQLite text/IDs, bound historical report caching and multi-file OpenCode reads, and terminate CLI descendants on timeout/cancellation. The source installation script verifies a fresh bundle before replacing an older copy and restores it if replacement fails.
• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• Release 1.3.1: chat usage, statistics and reliability fixes by @RunGuitarMan in #19

Full Changelog: v1.2.0...v1.3.1

LLM Usage 1.2.0

Download the ZIP below and move LLM Usage.app to Applications.

• Offline Claude pricing (#10): tariffs are refreshed and saved before each report. After a successful download, cached prices survive network failures and app restarts, and new offline usage continues to be calculated. Invalid responses do not overwrite valid prices; user pricing overrides retain priority.
• Excluded model reference data (#11): Models shows original tokens, cost and token breakdowns for excluded models, labeled Excluded from totals. Overview, Sessions, history, menu bar and widgets still exclude those amounts. Mixed sessions without a complete model breakdown remain one combined row.
• Native sidebar appearance (#14): Finder-style neutral selection adapts to light/dark appearance and active/inactive windows. Native keyboard navigation is preserved, and Overview uses a new grid icon.
• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• Release 1.2.0: offline pricing, model reference data and native sidebar by @RunGuitarMan in #18

Full Changelog: v1.1.5...v1.2.0

LLM Usage 1.1.5

Download the ZIP below and move LLM Usage.app to Applications.

• Amounts always retain the dollar sign; model exclusions reduce totals without adding inequality symbols or warning styles.
• Model exclusions: open the small Excluded models button in Models or the full list in Settings to remove tokens and cost from every date, including history, menu bar and widgets. Z.ai / GLM are excluded by default; click Include next to any excluded model to restore it.
• The sidebar and session controls stay within the window when narrowed; session details reserve enough room for all columns, and refreshing the menu popover keeps its anchor stable, including fullscreen Spaces.
• Claude only is the default update mode. It uses the dedicated Claude report so daily sessions and costs remain correct when the combined ccusage report omits them.
• Choose Settings → Data refresh → Update mode → All agents to include other local agents. Claude sessions are replaced with the dedicated report, and changing modes rebuilds the cache and history.
• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• Add feature request form and simplify bug report by @RunGuitarMan in #12

Full Changelog: v1.1.4...v1.1.5

LLM Usage 1.1.4

Download the ZIP below and move LLM Usage.app to Applications.

• Amounts always retain the dollar sign; model exclusions reduce totals without adding inequality symbols or warning styles.
• Model exclusions: open the small Excluded models button in Models or the full list in Settings to remove tokens and cost from every date, including history, menu bar and widgets. Z.ai / GLM are excluded by default; click Include next to any excluded model to restore it.
• The sidebar and session controls stay within the window when narrowed; session details reserve enough room for all columns, and refreshing the menu popover keeps its anchor stable, including fullscreen Spaces.
• Claude only is the default update mode. It uses the dedicated Claude report so daily sessions and costs remain correct when the combined ccusage report omits them.
• Choose Settings → Data refresh → Update mode → All agents to include other local agents. Claude sessions are replaced with the dedicated report, and changing modes rebuilds the cache and history.
• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• Fix model exclusions, sidebar sizing and fullscreen menu refresh by @RunGuitarMan in #8
• Fix narrow-window clipping and preserve normal totals with model exclusions by @RunGuitarMan in #9

Full Changelog: v1.1.2...v1.1.4

LLM Usage 1.1.2

Download the ZIP below and move LLM Usage.app to Applications.

• Claude only is the default update mode. It uses the dedicated Claude report so daily sessions and costs remain correct when the combined ccusage report omits them.
• Choose Settings → Data refresh → Update mode → All agents to include other local agents. Claude sessions are replaced with the dedicated report, and changing modes rebuilds the cache and history.
• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• Add English bug report issue form by @RunGuitarMan in #4

Full Changelog: v1.1.1...v1.1.2

LLM Usage 1.1.1

Download the ZIP below and move LLM Usage.app to Applications.

• Claude only is the default update mode. It uses the dedicated Claude report so daily sessions and costs remain correct when the combined ccusage report omits them.
• Choose Settings → Data refresh → Update mode → All agents to include other local agents. Claude sessions are replaced with the dedicated report, and changing modes rebuilds the cache and history.
• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• fix: restore Claude daily sessions and add update modes (v1.1.1) by @RunGuitarMan in #3

Full Changelog: v1.1...v1.1.1

LLM Usage 1.1

Download the ZIP below and move LLM Usage.app to Applications.

• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• feat: keep usage in the menu bar without a Dock icon (v1.1) by @RunGuitarMan in #2

Full Changelog: v1.0...v1.1

LLM Usage 1.0

Download the ZIP below and move LLM Usage.app to Applications.

• Requires macOS 26+ on Apple Silicon and Node.js with ccusage.
• Includes the menu bar app and desktop widget extension.
• Ad-hoc signed, without Apple notarization. For a trusted download, use System Settings → Privacy & Security → Open Anyway if macOS blocks it.
• SHA256SUMS.txt contains the ZIP's SHA-256 checksum.

See the installation guide for CLI setup and widget instructions.

What's Changed

• Set up PR tests and automatic macOS releases from v1.0 by @RunGuitarMan in #1

New Contributors

• @RunGuitarMan made their first contribution in #1

Full Changelog: https://github.com/RunGuitarMan/llm-usage-widget/commits/v1.0