English | [简体中文](README.zh-cn.md)

TokenScope

A local macOS panel for AI agent token usage, request counts, and API-equivalent cost. Opens a main window on launch and stays in the menu bar after closing.


Download & Install

Download the latest `TokenScope-*-macOS-universal.dmg` from [GitHub Releases](https://github.com/ckcsec/TokenScope/releases/latest), open it, and drag TokenScope into the Applications folder.

Current public packages are locally signed and not yet notarized by Apple. If macOS blocks the first launch, right-click TokenScope in Finder, choose **Open**, and confirm. Do not download installers from third-party sites other than this repository.

Requirements: macOS 13 Ventura or later, Apple Silicon and Intel Macs. See the [release notes](RELEASE_NOTES.md) for version changes.

Features

• Opens a main window on launch; closing it keeps the app in the menu bar — click the icon to reopen, right-click to quit
• Totals for tokens, input, output, cache, request count, and API-equivalent cost
• Usage broken down by agent, provider, model, and date
• Trend chart with per-day tokens, cached tokens, cache hit rate, and requests on hover
• Instant switching between Simplified Chinese, Traditional Chinese, and English
• Background resident; the user can opt i