A broadcast studio set for token use, with operators and panels for AI coding tools.
v0.0.3 - TUI + macOS desktop

Where did your tokens go last week?

Token Use reads the Claude Code, Codex, Cursor, and GitHub Copilot sessions already on your machine, stores them in a local archive, and shows usage by day, project, tool, model, shell command, or MCP server.

> Install Token Use Latest release
No API keys Read-only ingestion No telemetry Confirmed downloads only
CURRENT RELEASE
v0.0.3
Homebrew, TUI binaries, and the macOS desktop app
THE DASHBOARD

A local dashboard that answers the only question that matters: where did it go?

The TUI and desktop app share the same archive, filters, refresh logic, and export path. In the terminal, press 1-5 for time ranges, t for tools, p for projects, and e to export.

The tokenuse terminal dashboard showing cost, calls, sessions, cache hit, daily activity, model spend, project spend by tool, shell commands, MCP servers, and core tools.
SUPPORTED TOOLS

Four local parsers, one archive.

Token Use reads the session files your tools already write to disk. It does not proxy prompts or require editor extensions; it normalizes existing local history into one browsable usage archive.

Claude Code
~/.claude/projects/ + Claude Desktop
  • Exact tokens and cache reads
  • Bash commands and tool calls
  • MCP server and tool usage
live parser docs ->
Codex
~/.codex/sessions/**/rollout-*.jsonl
  • Per-turn token_count events
  • Cached input plus reasoning output
  • Tool call ledger
live parser docs ->
Cursor
Cursor state.vscdb
  • Exact tokens when present
  • chars / 4 estimate fallback
  • Agent KV rows
live parser docs ->
GitHub Copilot
~/.copilot/session-state/ + VS Code Chat
  • Legacy output tokens
  • VS Code Chat transcripts
  • Estimated transcript usage
live parser docs ->
GET STARTED

Install the current release.

Use Homebrew on macOS, or pull the latest TUI binary from GitHub Releases for Linux and Windows.

$ brew install russmckendrick/tap/tokenuse
$ tokenuse

$ brew install --cask russmckendrick/tap/tokenuse
$ open -a "Token Use"
$ curl -L -o tokenuse https://github.com/russmckendrick/tokenuse/releases/latest/download/tokenuse-linux-amd64
$ chmod +x tokenuse
$ sudo install -m 0755 tokenuse /usr/local/bin/tokenuse
$ tokenuse
PS> Invoke-WebRequest -Uri "https://github.com/russmckendrick/tokenuse/releases/latest/download/tokenuse-windows-amd64.exe" -OutFile "tokenuse.exe"
PS> .\tokenuse.exe
TUI: macOS - Linux - Windows - Desktop: macOS - v0.0.3