Skip to content

SimpleToken 0.1.0

Choose a tag to compare

@HanlunWang HanlunWang released this 05 Oct 14:08
6b68243

The download for 0.1.0 has been removed. Please get SimpleToken 0.1.1 instead: the same app, notarized by Apple, so it opens without a warning.

The first public release of SimpleToken: a native macOS menu-bar app and dashboard for your Claude Code and Codex usage. Tokens, cost and plan limits, all computed on your Mac.

Highlights

  • Dashboard of widgets in four sizes (small, medium, large, wide). Drag a widget to move it, right-click to resize it, and flip it over for its options and colour. Charts include cumulative usage against the previous period, plan limits with pace and a projection to the reset, models, a usage map and a tool-to-model flow, a calendar heatmap, a time-of-day punchcard, the token breakdown, this month's cost, and eight single-number stats.
  • Plan limits for the Claude session, weekly and model windows and for Codex, with optional notifications at thresholds you choose.
  • Menu bar item in four styles (text, two lines, rings, bars), and a drop-down panel with limits, today's usage, models, the last seven days and month-to-date cost.
  • Private by design. Usage comes from the local logs your tools already write. The only network request is the Claude plan-limit check, which uses a cookie you provide.
  • English and Simplified Chinese.

Install

Requires macOS 26 or later on Apple silicon.

  1. Download SimpleToken-0.1.0.zip below, unzip it and move SimpleToken.app to /Applications.

  2. This build is signed with a Developer ID but not yet notarized, so macOS will say it cannot check the app for malicious software. Open it once with right-click → Open, or run:

    xattr -dr com.apple.quarantine /Applications/SimpleToken.app

SimpleToken lives in the menu bar: click its icon for the panel, or ⌥-click for the main window. See Getting your usage in for what to set up.

Checksum

SHA-256  75baed0f3fc88baf180f77bae65ed250d49bb191bc5c34862f5f1944f5d7a45c  SimpleToken-0.1.0.zip