Claude Sessions Dashboard

A local analytics dashboard for Claude Code — visualise your session costs, token usage, tool calls, models, and activity patterns across all your projects.

All data is read from your local ~/.claude/ directory. Nothing leaves your machine.

Features

• Cost tracking — daily spend, monthly projection, per-session breakdown
• Session explorer — searchable table with real session names (as shown in Claude Desktop), anomaly flagging, pin/star sessions
• Conversation viewer — full chat history with markdown rendering, tool call cards, token counts
• Model analytics — Sonnet/Opus/Haiku usage split, model timeline
• Tool attribution — which tools consumed the most tokens
• Activity heatmaps — hourly, weekday, and daily patterns
• Agent chain view — visualise sub-agent delegations
• Project comparison — side-by-side stats across projects
• PDF report — export any session as a printable report
• Dark/light theme, auto-refresh, keyboard shortcuts, CSV export, deep links
• Mac app — double-click .app bundle, lives in the menu bar

Quick start

npx @jeet427/claude-sessions-dashboard

Or install globally:

npm install -g @jeet427/claude-sessions-dashboard
claude-dashboard

Opens at http://localhost:3141 automatically.

Options

--port <n>          Port to listen on (default: 3141)
--no-browser        Don't open the browser automatically
--daily-budget <n>  Show an alert when daily spend exceeds this amount (USD)
--digest            Print a weekly text summary and exit (no server)

Mac app

Build a standalone double-click app (requires Xcode command-line tools):

./scripts/build-mac-app.sh

Produces dist/Claude Dashboard.app and a distributable dist/claude-dashboard-mac.zip. Recipients need Node.js 18+ (any Claude Code user already has this).

Keyboard shortcuts

| Key | Action | |-----|--------| | 1–6 | Switch tabs | | r | Refresh data | | / | Focus session search | | Esc | Close modal | | ? | Show help |

Data & privacy

• Reads ~/.claude/projects/**/*.jsonl and ~/.claude/sessions/*.json — your local Claude Code session files
• Notes and pins are saved to ~/.claude/dashboard-notes.json and ~/.claude/dashboard-pins.json
• The dashboard serves only on localhost — no data is sent anywhere

Requirements

• Node.js 18+
• macOS or Linux (Windows untested)

License

MIT