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

Track AI coding token usage and costs locally.

Token Use reads Claude Code, Codex, Cursor, GitHub Copilot, and Gemini history already on your machine, stores it in a local archive, and adds local Insights plus optional quota gauges when you choose to sync them.

> Install Token Use Latest release
No API keys Read-only ingestion No telemetry Opt-in syncs only
CURRENT RELEASE
v0.0.11
Homebrew, TUI binaries, and desktop builds
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, Usage view, Insights, and report flow. In the terminal, press 1-5 for time ranges, u for Usage, i for Insights, and e for reports.

Desktop gallery

Five native app views

Token Use desktop app overview showing cost, calls, sessions, cache hit, input and output tokens, activity charts, project spend, model spend, shell commands, and MCP servers. Desktop Overview Token Use desktop app deep dive screen showing activity trends, by-project spend, top sessions, project spend by tool, model efficiency, shell commands, and MCP servers. Desktop Deep Dive Token Use desktop app usage screen showing Claude Code, Codex, Gemini, Cursor, and Copilot console usage panels with pulse charts, costs, calls, tokens, and quota rows. Desktop Usage Token Use desktop app insights dashboard showing current read status, estimated weekly savings, risk and warning counts, top actions, signal map, and latest issue. Desktop Insights Token Use desktop app config screen showing money and data, tool integrations, advice engine, local data, and desktop settings. Desktop Config

TUI gallery

Five keyboard-first views

Token Use TUI overview showing cost, calls, sessions, cache hit, input and output tokens, activity pulse, project spend, model efficiency, shell commands, and MCP servers. TUI Overview Token Use TUI deep dive screen showing activity trend, by-project spend, top sessions, project spend by tool, model efficiency, shell commands, and MCP servers. TUI Deep Dive Token Use TUI usage screen showing Claude Code, Codex, Gemini, Cursor, and Copilot console usage panels with pulse charts, costs, calls, tokens, quota reset times, and plan names. TUI Usage Token Use TUI insights screen showing estimated weekly savings, risks, warnings, info, advice text, warnings, evidence, and keyboard shortcuts. TUI Insights Token Use TUI configuration screen showing currency override, exchange rates, pricing books, tool integrations, advice tool, local files, pricing sources, and keyboard shortcuts. TUI Config
SUPPORTED TOOLS

Five local parsers, one archive.

Token Use reads the session files your tools already write to disk. It normalizes local history into one browsable archive, while limits-only quota sync for Copilot, Claude.ai, and ChatGPT (Codex) stays separate and opt-in from Config.

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 ->
Gemini
~/.gemini/tmp/<project_hash>/chats/
  • Exact usage and cache reads
  • Thought token tracking
  • Tool calls
live parser docs ->
GET STARTED

Install the current release.

Use Homebrew on macOS, or pull checksummed TUI and desktop builds from GitHub Releases for Linux and Windows.

$ brew install russmckendrick/tap/tokenuse
$ tokenuse

$ brew install --cask russmckendrick/tap/tokenuse-desktop
$ 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 - Linux - Windows - v0.0.11