TokenTrace

What it does

TokenTrace provides a privacy-focused, local-first dashboard that scans AI CLI usage logs (Claude Code, Codex, etc.) to track tokens, costs, and session analytics. It transforms raw logs into actionable financial and performance data without sending any telemetry to the cloud.

Key features

• Preflight Checks: Determine if local usage evidence is ready before starting expensive agent runs.
• Cost & Token Tracking: Trace every cent back to local files with a high-confidence evidence trail.
• Local-First Privacy: No cloud accounts or telemetry; all data stays in a local SQLite database.
• Interactive Dashboard: Visualize session timelines, token spikes, and model-rate state.
• Repair Queue: Identify and fix missing cost data through guided local repair groups.

Installation

Run via npx:

npx tokentrace

Or install globally:

npm install -g tokentrace

Supported hosts

• Claude Desktop
• Codex
• Cursor