claude-dashboard 0.1.0

A terminal TUI dashboard that renders Claude Code usage reports with token stats, project breakdowns, and language distribution.
claude-dashboard-0.1.0 is not a library.

Claude Code Dashboard

A Rust TUI tool that reads your Claude Code .claude data directory and renders monthly/yearly usage reports right in your terminal.

license

Features

  • Overview — all-time project count, total sessions, messages, token consumption, model usage breakdown, programming language distribution
  • Monthly report — daily activity histogram, per-model tokens, per-project token table for any month
  • Yearly report — monthly aggregated activity, yearly token breakdown by model and project
  • Language detection — scans project directories (up to depth 3) to show your programming language mix
  • Keyboard-driven — navigate with tabs, arrow keys, and vim-style scrolling

Installation

git clone https://gitcode.com/eedt/claude-dashbord
cd claude-dashboard
cargo build --release

The binary will be at target/release/claude-dashboard (or .exe on Windows).

Usage

# Uses %USERPROFILE%\.claude (Windows) or ~/.claude (Unix) by default
cargo run

# Override the data directory
cargo run -- --data-dir /path/to/.claude

Controls

Key Action
1 2 3 or Tab Switch between Overview / Monthly / Yearly
← → Previous / next month or year
↑ ↓ or j k Scroll tables
PgUp PgDn Page scroll
r Refresh data from disk
q or Esc Quit

How it works

Reads three data sources from your .claude directory:

  • stats-cache.json — aggregate stats (daily activity, model tokens, session counts)
  • history.jsonl — user message history, used to map session IDs to real project paths
  • projects/<encoded>/ — per-project session JSONL files with detailed token usage per assistant message

Language detection runs in a background thread using walkdir to scan project directories for file extensions.

Requirements

  • Rust 1.70+
  • A .claude directory with Claude Code usage data (generated automatically by Claude Code)