Tokenscope app icon

Tokenscope

tokenscope.app

A free, open-source macOS menu bar dashboard that monitors Claude Code token usage, costs, and session activity from local logs without network access.

Developer AI Open Source Free
Tokenscope screenshot showing the app interface

Tokenscope is a free, open-source menu bar dashboard for macOS that monitors Claude Code token usage and associated API costs. The app reads local JSONL session logs without network access, telemetry, or account requirements. (Free, open-source)

The menu bar widget displays real-time token consumption across active Claude Code sessions. Daily, weekly, and monthly usage breakdowns separate costs by AI model, covering Claude, GPT, Gemini, and Llama instances configured within Claude Code. Bar charts and donut charts visualize where compute spend is concentrated across each model tier, making it straightforward to identify high-cost sessions.

Cache analytics surface prompt cache hit rates for Claude sessions, helping identify optimization opportunities to reduce API costs. An MCP and skill monitoring panel shows which Model Context Protocol servers and custom skills are being invoked, providing visibility into tool call frequency. A twelve-month token usage heatmap, styled after GitHub’s contribution graph, provides a long-term view of Claude Code session patterns and intensity.

The privacy-first design reads data exclusively from ~/.claude/projects/ on the local machine. No data leaves the device, and no login or API key is required. Tokenscope is available via Homebrew or as a direct .dmg download from the GitHub releases page.

System requirements: macOS 14.0 Sonoma or later; Apple Silicon M1 or newer; Claude Code must be installed with existing session logs.

Pricing: (Free, open-source — MIT License)

Limitations: Requires Apple Silicon — Intel Macs are not supported. Only tracks usage from Claude Code sessions; standalone Claude.ai web usage is not captured. Requires Claude Code to generate JSONL log files before any metrics appear in the dashboard.

Alternatives: Claude Usage SysTray provides a simpler token indicator for Claude Code. The claude.ai usage dashboard shows API consumption at the account level. The CCUSAGE CLI tool offers command-line token reporting for Claude Code sessions.

Suitable for users who run Claude Code extensively and want detailed insight into token costs, model usage patterns, and cache efficiency without sending session data to external services.

FAQ

What does Tokenscope do?+

Tokenscope is a menu bar app for macOS that monitors token usage and costs for Claude Code sessions. It reads local JSONL logs from ~/.claude/projects/ to display real-time breakdowns by model, daily/weekly/monthly totals, cache analytics, MCP tool usage, and a twelve-month heatmap — all without uploading data or requiring API keys.

Is Tokenscope free?+

Yes. Tokenscope is completely free and open-source under the MIT License. There is no paid tier, no subscription, and no data collection of any kind.

How do I install Tokenscope on macOS?+

Install via Homebrew: brew install --cask hdusy/tokenscope/tokenscope. Alternatively, download the universal .dmg from the GitHub releases page at github.com/gmnbs/Tokenscope. Claude Code must be installed before Tokenscope has session data to display.

Does Tokenscope run on Apple Silicon?+

Tokenscope requires Apple Silicon (M1 or later) and macOS 14.0 Sonoma or newer. Intel Macs are not supported. Claude Code must be installed and have generated session log files for the dashboard to populate.

What AI models does Tokenscope track?+

Tokenscope tracks token consumption across Claude, GPT, Gemini, and Llama models used within Claude Code sessions. Each model appears in separate cost breakdowns with bar charts and donut charts showing relative spend.

Where does Tokenscope store data, and does it send anything to the internet?+

Tokenscope reads data exclusively from ~/.claude/projects/ on the local machine. The app is read-only by design: no telemetry, no API key required, and no data leaves the device.

Related Apps

VibeProxy icon

VibeProxy

Free, open-source macOS menu bar app routing AI coding tool requests through your existing Claude Code, ChatGPT, or Gemini subscriptions — no API keys needed.

developeraiopen-source +1 more
Claude Account Switcher icon

Claude Account Switcher

Switch between multiple Claude Code and Codex CLI accounts from the Mac menu bar with live usage metrics and automatic failover. (Free, open-source)

developeraiopen-source +1 more
Mimir icon

Mimir

Open-source menu bar app that shows real-time usage limits and reset countdowns for AI coding tools: Claude, Codex, Gemini, and Antigravity.

aideveloperfree +1 more
MergeMole icon

MergeMole

A macOS menu bar app that triages GitHub pull requests by AI-generated priority and effort scores, with one-line summaries and review status — all processed on-device.

developeraifree +1 more