Claude Session Dashboard

A local web dashboard for visualizing your Claude Code session history. Browse usage trends, explore sessions, and view per-project statistics — all from your browser.

Features

• Usage Overview — Daily activity trends (messages, sessions, tool calls) with interactive charts
• Session Browser — Searchable list of all sessions with project name, duration, and message counts
• Session Detail — Full conversation view with user/assistant messages and collapsible tool call blocks
• Project Statistics — Per-project usage breakdown with sortable tables and summary cards
• Dark Theme — Terminal-friendly aesthetic designed for developers
• Zero Config — Reads directly from ~/.claude/ — no database, no data import, no setup

Screenshots

Sessions List

Project Statistics

Quick Start

git clone https://github.com/user/claude-session-dashboard.git
cd claude-session-dashboard
npm install
npm run dev

Open http://localhost:3000 in your browser.

Prerequisites

• Node.js 18+
• Claude Code installed and used (the dashboard reads from ~/.claude/)

How It Works

Claude Code stores session data in ~/.claude/ as JSONL files. This dashboard reads those files directly:

Data Source	What It Powers
~/.claude/stats-cache.json	Overview charts and daily statistics
~/.claude/projects/*/	Session list, project statistics
~/.claude/projects/*/<id>.jsonl	Session detail / conversation view

All data stays on your machine. Nothing is sent anywhere.

Tech Stack

• Next.js 15 (App Router, Server Components)
• React 19
• Tailwind CSS v4
• shadcn/ui (New York style)
• Recharts for charts
• Lucide for icons

Project Structure

src/
  app/
    page.tsx                        # Overview dashboard
    sessions/
      page.tsx                      # Session list
      [project]/[id]/page.tsx       # Session detail
    projects/
      page.tsx                      # Project statistics
  components/
    layout/                         # Sidebar, header
    dashboard/                      # Stat cards, charts, recent sessions
    sessions/                       # Session list, detail, message bubbles
    projects/                       # Project cards, sortable table
  lib/
    data/                           # Data layer (JSONL parsing, stats, etc.)
    format.ts                       # Shared formatting utilities

Roadmap

• Terminal TUI version
• Static HTML report export
• Token usage / cost tracking
• Session search (full-text across conversations)
• Date range picker for charts

License

MIT