v1.0.2 — launch-day polish

Polish release. Everything here was found by running the product rather than reading it.

Fixed

• install.sh started two copies. The LaunchAgent starts Tokease on load, and the script then offered to start it again: answering yes to both put two identical icons in the menu bar, and the second one survived Quit. The prompt is now only offered when auto-start was declined.
• Removed the "Sponsor / Donate" menu item. GitHub Sponsors isn't set up, so it redirected to a bare profile.
• The Support submenu now shows the version, so a bug report can say which build it is.

Docs

• CONTRIBUTING.md and the PR template no longer ask for ruff format ., which would have turned a contributor's first PR into a 1124-line reformat. Lint stays ruff check.
• Version is consistent across the app bundle, the landing page and the tag.
• CHANGELOG documents v1.0.1 and v1.0.2.

Install

brew install tpatrouillat/tap/tokease
brew services start tokease

Requires macOS 12 Monterey or later and a Claude Pro or Max plan. Zero config if the Claude desktop app is running. MIT.

v1.0.1 — reliable statusline capture, honest alert claim

Patch release. Recommended for everyone, especially if you use the Claude Code statusline capture.

Fixed

• The statusline capture no longer wipes good readings. Claude Code renders the statusline before it has any rate_limits to hand over (session start, /clear, resume). The capture script wrote anyway, replacing your captured windows with an empty payload, and the app dropped to "Waiting" mid-session. It now keeps the previous reading and lets the app flag it stale on its own schedule. This mainly affected CLI-only users, who don't have the Claude desktop app as a backstop.
• Honest alert claim. Threshold notifications at 80% / 95% exist in the code, but macOS only delivers notifications for a signed .app bundle, so they never fire on a Homebrew or source install. The docs, the landing page and the Settings label now say so instead of promising a banner that can't appear. A signed .app build is on the roadmap.

Also in this release

• ROADMAP no longer contradicts itself on the zero-network rule and on signed .app builds.
• The landing page no longer names other trackers: the argument stands at category level, and the claim as written didn't hold for every project it named.
• Install docs now include brew services start tokease everywhere — without it the app installs and nothing appears.
• Removed the Sponsor button (GitHub Sponsors isn't set up, the link led nowhere).

Install

brew install tpatrouillat/tap/tokease
brew services start tokease

Requires macOS 12 Monterey or later and a Claude Pro or Max plan. Zero config if the Claude desktop app is running. Full test suite runs in CI on Python 3.10-3.13. MIT.

v1.0.0 — token-free, two local sources

First stable release. Tokease shows your remaining Claude 5-hour and weekly limits as two rings in the macOS menu bar, reading only local files official Claude apps already write. No token read, no Keychain access, no network calls.

Superseded by v1.0.1, which fixes the statusline capture wiping good readings. Install v1.0.1 instead.

Highlights

• Two local sources, freshest wins: the Claude desktop app's quota history (zero config, ~5 min refresh) + the Claude Code statusline capture (optional, adds reset countdowns).
• Token-free by construction: the legacy endpoint mode (Keychain token + undocumented API) is fully removed, frozen for transparency at tag v0.9.0-endpoint.
• Honest freshness: stale data is flagged, expired resets show as "--", never a wrong countdown.
• Full test suite in CI on Python 3.10-3.13. MIT.

Install

brew install tpatrouillat/tap/tokease
brew services start tokease

See the README for source install and statusline wiring.