takeru.
English
Back to Token MeterRELEASE HISTORY

Release notes.

What changed in every Token Meter release, with system requirements and installation steps.

Token Meter 1.2.11

This update refreshes plan names and makes first-time setup easier to read.

Changes

  • Show Codex Pro 100, Pro 200, and Pro 500 instead of internal plan identifiers. Use current names for other recognized Codex plans, including Business.
  • Show the weekly account limit for all three Codex Pro tiers in the menu bar and provider card, without substituting a model-specific short window.
  • Update Claude usage guidance to cover subscription plans beyond Pro / Max, and remove Claude-specific OAuth guidance from Copilot connections.
  • Default to a compact menu bar with the Meter icon hidden on first launch. Existing saved preferences are preserved.
  • Fix the Japanese “Menu bar format” label wrapping vertically during onboarding. Refresh all four languages of setup and usage guidance.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Choose “Check for Updates…” in the app menu, or unzip TokenMeter-1.2.11.zip and move TokenMeter.app to /Applications.

The app is Developer ID signed and notarized by Apple. Sparkle verifies update ZIPs with an EdDSA signature.

Token Meter 1.2.10

This patch keeps Codex quota readings in chronological order and shows when the quota was actually observed.

Changes

  • Preserve the observation timestamp when restoring Codex quota readings at launch, so an older unread session cannot overwrite a newer recovered value.
  • Show the time of the Codex quota log event instead of the time the file was checked. Repeated refreshes no longer make an unchanged reading appear newly updated.
  • Keep newer Codex plan information when importing older session logs.
  • The product introduction, release history, privacy policy, and Claude sign-in guide are available on takeruf.com.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Token Meter updates from the menu with “Check for Updates…”. You can also unzip TokenMeter-1.2.10.zip and move TokenMeter.app to /Applications.

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.9

This patch makes the Codex weekly percentage reliable again and gives the update alert a focused release-notes view.

Changes

  • Select each Codex quota bucket using the timestamp inside its usage event, preventing an older session opened later from replacing the current weekly percentage.
  • Do not announce a quota reset when a stale reading has the same reset deadline as the current quota.
  • The update alert now embeds a dedicated, header-free page with only the offered version's notes and a compact language selector.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Token Meter updates from the menu with “Check for Updates…”. You can also unzip TokenMeter-1.2.9.zip and move TokenMeter.app to /Applications.

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.8

This update makes Codex quota reporting consistent across the menu bar, dashboard, and refresh actions.

Changes

  • Codex Pro now always displays its weekly account quota; the shared 5-hour / weekly preference remains available for Claude Code and other Codex plans.
  • Keep regular Codex quota separate from Codex Spark. You can hide Spark quota bars in Settings under Codex without changing normal Codex reporting.
  • Fix a case where refreshing could show a Spark percentage as the regular Codex percentage or incorrectly send a weekly reset notification.
  • When Claude token data cannot be read, show an em dash instead of a stale token value.
  • The in-app update alert now opens the release notes for the offered version.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.8.zip and move TokenMeter.app to /Applications. Existing installations can update from the menu with “Check for Updates…”.

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.7

This update keeps usage and quota information separate when the same provider exposes multiple models or quota windows.

Changes

  • Separate regular Codex usage from Codex Spark 5-hour and weekly quota windows, so Spark activity no longer looks like a reset of the regular Codex quota.
  • Preserve Codex usage history independently for each model, including migrations from existing sessions without duplicating past events.
  • Make Claude and Copilot multi-model usage display deterministic when more than one model appears in local logs.
  • Improve notification threshold and reset handling for providers with multiple quota windows.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.7.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.6

This update makes the manual Claude Code sign-in and Keychain access guide fully available in all four languages supported by Token Meter.

Changes

  • Expanded the Claude Code manual sign-in guide into complete English, Japanese, Simplified Chinese, and Korean versions. Each language now covers checking the Claude Code installation, signing in with /login, granting macOS Keychain access, recovering after selecting Deny, and troubleshooting common errors.
  • Added language links at the top of the guide and aligned button and setting names with the localized labels shown in Token Meter.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.6.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.5

This update turns "your Claude Code sign-in expired" into a one-click fix, and stops the widget from getting stuck on its empty state.

Changes

  • Added a one-click way out of every Claude connection problem. Where Token Meter reports an expired sign-in, a missing Claude Code install, or a denied Keychain item — the menu bar card, Setup, and the setup guide — it now offers a button that does the next step for you: opening Terminal with claude ready for /login, opening the download page, or performing the single Keychain read that makes macOS show its approval dialog.
  • Every one of those steps asks first. A popup states exactly what is about to happen before anything opens, and each popup also links to the written manual steps for anyone who would rather do it by hand. When a step turns out to reveal a different problem — the Keychain read succeeds but the token has expired, or claude is not installed after all — Token Meter offers the next step instead of dead-ending.
  • The Keychain approval can now be granted deliberately. Right after you enable Claude Pro / Max usage, in the setup guide and in Settings, a button performs the credential read on demand, so macOS asks for approval one click after you asked for it rather than out of a background refresh. Choosing "Always Allow" in the system dialog stops the prompts for good.
  • Added a documentation page covering all of it by hand: checking the install, /login, the Keychain approval, and what to do if you denied it. It is linked from the app and from the setup section of the website.
  • Fixed the widget showing "No data" after being added or resized. macOS renders the placeholder while a widget waits for its first timeline, and the placeholder held no data; it now shows the last good snapshot. Widget reloads are also rate-limited, so a burst of refreshes at launch no longer spends WidgetKit's reload budget and leaves a later reload dropped.
  • Changed the Clear widget background to a translucent frosted material. It now genuinely shows the wallpaper through the widget in every appearance mode, and works on every supported macOS version — previously it required macOS 26 and looked opaque unless the system's widget-dimming setting was on.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.5.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.4

This update lets you choose the widget background style and makes the widget look right in the system's tinted (accented) rendering mode.

Changes

  • Added a widget background setting: keep the existing Solid background, or switch to Clear (Liquid Glass) for a translucent glass look. Clear is offered only on macOS 26 and later, where the Liquid Glass API exists; on older systems the widget stays Solid. The choice is stored alongside your existing language and notation settings and the widget refreshes as soon as you change it.
  • Optimized the widget for the system's tinted (accented) appearance: brand icons, the progress-bar fill, the headline percentage, and the large-widget chart line now take the accent colour while labels stay legible, so the light, dark, tinted, and clear widget appearances all render cleanly.

System Requirements

  • macOS 14.0 or later (Clear / Liquid Glass background requires macOS 26 or later)
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.4.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.3

This update adds a one-click sign-in shortcut for expired Claude Code sessions, and brings both time windows to the small widget.

Changes

  • Added a "Sign in to Claude Code" button wherever Token Meter reports an expired or unauthorized Claude session (Setup and the menu bar popover). It opens Terminal and runs claude for you — you only need to type /login once it starts. The button only appears once Token Meter has confirmed claude is actually on your PATH, and Token Meter still never reads, stores, or refreshes your Claude credentials itself.
  • The small (2×2) widget now shows both the 5-hour and weekly reset countdowns for Claude and Codex, stacked compactly, instead of just the 5-hour reset for Claude alone.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.3.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.2

This update fixes a reset notification that named the wrong limit, and makes every "Today" in the app agree. Codex and Copilot token counts were also being overstated.

Changes

  • Fixed reset notifications naming the wrong limit. When the 5-hour limit rolled over, the weekly limit often became the tightest one left, and the notice read "Weekly quota reset" — while the weekly limit had not moved at all. Worse, that mislabelled notice then suppressed the genuine 5-hour notices for the rest of the week. Each limit is now tracked on its own.
  • Fixed Codex and Copilot token counts being overstated. Codex reports reasoning tokens inside its output count and cached tokens inside its input count, but the app added them on top, so "work" could come out higher than the total it is part of — Codex showed 26.23M of 26.20M. Claude Code's figures were correct and are unchanged.
  • Made "Today" mean the same thing everywhere. The dashboard showed real work while the menu bar, the widget and the widget's chart showed cache-inclusive totals — the same label with numbers up to 50x apart. Every surface now leads with real work and shows the total beside it.
  • The 5-hour, weekly and "Last 7 days" rows now show real work with their total, matching the cards next to them. Previously "Last 7 days" read 157M directly above "Today" at 1.19M, which invited an impossible comparison.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.2.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.1

This update fixes Japanese units appearing in the English interface, makes the 90-day chart readable, and lets Japanese, Chinese and Korean users choose how token counts are abbreviated.

Changes

  • Fixed the dashboard charts labelling their axes in the system language instead of the one you picked. On a Japanese Mac with the English interface selected, the charts read "6億" and "16日" where they should have read "600M" and "16".
  • The 90-day chart now labels every 10th day instead of every day, so the dates no longer collide into an unreadable smear, and it names the month — a bare "6" says little across three months.
  • Added a number format setting for Japanese, Chinese and Korean: token counts can now read as either K/M/B or in myriad units (万 / 億). The choice applies everywhere at once — charts, cards, menu bar and widget — so no two places disagree. K/M/B stays the default.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.1.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.2.0

This update adds GitHub Copilot CLI tracking, a setup step that verifies the connection actually works, and longer comparison periods on the dashboard.

Changes

  • Added GitHub Copilot CLI usage tracking. It counts tokens only, and its models overlap with Claude Code, so it is off by default — turn it on in Settings if you use Copilot in the terminal.
  • Added a connection check to the setup guide. It verifies that usage can actually be read for what you picked, not just that a tool is installed, and tells you exactly what to fix — signed out, no session log yet, or macOS blocking access. Press "Re-check" after fixing, or finish setup now and connect later while Token Meter keeps looking in the background.
  • Added a 90-day range to the dashboard, along with "vs yesterday", "vs prev 7 days", "vs prev 30 days", and "vs prev 90 days" comparisons.
  • Token Meter now notices when Claude Code's sign-in has expired and tells you to run /login instead of silently showing no plan usage.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.2.0.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.9

This update improves the usability of the setup guide and dashboard.

Changes

  • Added an installation steps screen to the setup guide when command-line tools for the selected provider are not installed. Skips automatically if already installed.
  • Added a "Run setup guide again" button to Settings to let you reopen the onboarding flow anytime.
  • Changed the "Hourly Trend Today" on the dashboard to a line chart to make usage patterns clearer. Hover to view token counts for each provider.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.9.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.8

This update refines display and language support, making it easier and more natural to check usage limit status and update times.

Changes

  • Dates, times, and relative times are now displayed according to the selected app language, while preserving system 12/24-hour clock preferences.
  • Remaining usage, last update, reset times, and notification messages now support English, Japanese, Chinese (Simplified), and Korean.
  • Reset notifications now include target limit types (e.g., "5-hour" or "weekly") for better clarity.
  • Axis labels on the dashboard daily charts are now precisely aligned with data points.
  • Widget day-of-week displays now respect the selected app language, and remaining usage displays and accessibility labels have been improved.
  • Refined OAuth endpoint labeling and phrasing in Settings and Setup screens.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.8.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.7

This update significantly improves the readability of the dashboard and widgets, making "actually processed tokens" visible at a glance.

Changes

  • Unified dashboard metrics to "actually processed tokens" (excluding cached content resent each turn). Summary cards now emphasize the processed amount, with the total (including cache) shown alongside.
  • Consolidated "Recent Activity" into sessions. One row represents one session, showing time, turns, processed tokens, and cached tokens together.
  • The Today view now displays an hourly bar chart (0-23 hours) instead of a daily chart.
  • Connected line charts with straight lines and added a compact tooltip showing token counts when hovering over data points.
  • Merged "Plan usage remaining" and "Current windows" into a single "Usage windows" section, showing remaining percentage and tokens in one row per limit. Fixed the toggle for 5-hour/weekly limits to apply to both.
  • Removed the redundant "Claude vs Codex" chart.
  • Changed the Large widget's 7-day chart to a line chart with axis labels and fixed rendering cut-offs.
  • Fixed an issue where widgets would temporarily display empty content right after startup (now falls back to the most recent data).

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.7.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.6

This update refreshes dashboard and widget charts to make daily trends easier to track with line and bar charts.

Changes

  • Changed "Daily tokens" on the dashboard from a bar chart to a line chart, color-coded by provider.
  • Hovering over points on the line chart now displays the date and token counts by provider in a tooltip.
  • Refreshed the Large widget's 7-day sparkline into a bar chart with axis labels.
  • Aligned the language selector in Settings with labels and right-aligned menus for better visibility.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.6.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.5

This update introduces full support for four languages (English, Japanese, Simplified Chinese, and Korean) across the main app and widgets. You can switch languages anytime from within the app, both during first launch and from Settings.

Changes

  • Added full support for English, Japanese, Simplified Chinese, and Korean across the entire app.
  • Added a language selector to all onboarding screens.
  • Added language settings to the top of the Settings view.
  • Reflected the selected language in the menu bar, notifications, connection statuses, and diagnostics.
  • Propagated the selected language to widgets, enabling multilingual labels within widgets.
  • Allowed choosing between the 5-hour limit (default) or weekly limit for the menu bar display (automatically falls back to weekly if a 5-hour limit is not provided).
  • Ensured widget snapshot write ordering, fixing a race condition where older Codex usage data could overwrite the newest value.
  • Validated all onboarding and Settings screens at the minimum window size to adjust wrapping and truncation for longer localized strings.
  • Updated download links and language support information on the About page.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.5.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.4

This update ensures longer-term Codex usage history ingestion and improves widget and dashboard displays. It also makes update notifications harder to miss as a menu bar app.

Changes

  • Fills in older untracked Codex sessions on the first update to fix historical gaps (including 30-day views).
  • Changed the Widget's 7-day trend chart from a bar chart to a line chart.
  • Updated Widget remaining bar drawing implementation for more stability.
  • Brings Sparkle's update window to the foreground when an update is found.
  • Fixed a layout issue where the Codex row in the Token Breakdown was shifted to the center.
  • Simplified date labels in "Daily tokens" to show only the day of the month, preventing text truncation.
  • Consolidated Menu Bar settings into Setup, removing duplicate controls in Settings.
  • Replaced the product screenshots on the About page with high-resolution ones using actual widgets.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.4.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.3

This update aligns Codex remaining usage with correct account-level limits and improves menu bar and widget displays. It also introduces the official multi-language About page.

Changes

  • Fixed an issue where model-specific Codex limits were incorrectly treated as account-wide limits.
  • Repaired incorrect Codex remaining usage data stored in previous versions upon application startup.
  • Fixed a layout bug in Compact mode where Claude and Codex could not be shown simultaneously.
  • Changed the widget's reset label to "5h limit".
  • Added the official About page containing screenshots and widget showcases.
  • Enabled support for English, Japanese, Chinese, and Korean on the About page.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.3.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.2

This patch update improves menu bar readability in Compact mode by displaying each provider logo alongside a shortened usage value.

Changes

  • Shows both Claude and Codex when enabled in the format of [Claude Logo] 68% [Codex Logo] 42%.
  • Removed the separator dot (·) between providers in Compact mode.
  • Removed the word "left" from usage percentages in Compact mode.
  • Grouped logos and values as fixed pairs to prevent them from splitting across the menu bar.
  • Falls back to raw token counts or — when remaining percentage is unavailable.
  • Unified the onboarding Compact preview with actual menu bar rendering.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.2.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.1

This patch update fixes the rendering size of brand logos in the menu bar's Compact mode.

Changes

  • Renders Claude and Codex logos as AppKit images specific to Status Items.
  • Fixed logic to set logical sizes in advance, preventing intrinsic sizes of 512px source images from propagating to the menu bar.
  • Treated Claude and Codex logos as macOS template images to adapt to light/dark modes and selection states.
  • Unified previews in Settings, Setup, and onboarding with actual menu bar rendering.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.1.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.1.0

This update clarifies the first-run experience and improves the menu bar's Compact mode by focusing on brand logos.

Changes

  • Added a 4-step onboarding flow:
    • Brief introduction to Token Meter
    • Select providers to display (Claude / Codex)
    • Choose menu bar items and layout styles
    • Confirm settings and open the Dashboard
  • Added a fallback for when the main window fails to display on first run.
  • Improved window behavior to reliably bring existing windows to the foreground when opening the Dashboard or Settings.
  • Changed the menu bar Compact text from C / X to the Claude and Codex brand logos.
  • Updated previews in Settings and Setup to match the actual menu bar appearance.
  • Added screenshots of onboarding screens to the documentation.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.1.0.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.0.1

This update improves the distinction between Claude and Codex and enhances macOS widget displays.

Changes

  • Added official logos for Claude and Codex to the Dashboard, menu bar, Settings, Setup, and widgets.
  • Enabled automatic inversion for the Claude icon to match system light/dark modes.
  • Applied dedicated light/dark assets for the Codex icon.
  • Added Claude's 5-hour reset time to the 2x2 widget.
  • Redesigned the 2x4 widget into a two-column layout for Claude and Codex to fix a bottom truncation issue.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

Unzip TokenMeter-1.0.1.zip and move TokenMeter.app to /Applications. If you are already using Token Meter, you can update from the menu by clicking "Check for Updates…".

The app is Developer ID signed and notarized by Apple. The update ZIP is also verified by Sparkle's EdDSA signature.

Token Meter 1.0.0

First public release of Token Meter. Check your Claude and Codex usage directly from the macOS menu bar, Dashboard, and desktop widgets.

Key Features

  • Aggregates input, cached, and output tokens from local logs, grouped by model and day.
  • Displays remaining usage percentage and reset times for 5-hour/7-day windows when Claude OAuth integration is enabled.
  • Displays 5-hour and weekly usage rates, remaining amounts, and reset times reported by Codex.
  • Supports Small, Medium, and Large macOS widgets.
  • Hosts Dashboard and Settings in tabs within the same window.
  • Allows toggling the menu bar Meter icon in Settings.
  • Supports in-app updates, downloads, and installation powered by Sparkle.

Enhancements & Fixes

  • Brings existing windows to the front when opening Dashboard or Settings.
  • Replaced the settings tab icon with a gear.
  • Updated UI text to "Claude" as Claude Code's limits are shared across Claude.
  • Fixed widget loading to ensure it reads the App Group snapshot created by the main app.
  • Shortened widget refresh intervals when data has not been generated yet.

System Requirements

  • macOS 14.0 or later
  • Apple Silicon / Intel Mac (Universal Binary)

Installation

  1. Download and unzip TokenMeter-1.0.0.zip.
  2. Move TokenMeter.app to /Applications.
  3. Open Token Meter.

The app is Developer ID signed and notarized by Apple. Subsequent updates can be installed via "Check for Updates..." in the app.

Privacy

Token history aggregation and storage are fully local. The app never saves prompt text, response bodies, or credentials. It connects to Anthropic only when Claude OAuth usage tracking is explicitly enabled, and accesses the GitHub release feed solely to check for updates. For more details, see the Privacy Policy and Data Sources.