📊 Claude Code Dashboard

Local-first analytics dashboard for Claude Code usage.

Understand your AI coding patterns, costs, and performance — all without leaving your machine.

Zero telemetry. Zero outbound connections. Your data never leaves localhost.

⚡ Quick Start

npx claude-code-insights

Opens a dashboard at http://localhost:3838 analyzing your Claude Code sessions from ~/.claude/.

Global install: npm install -g claude-code-insights

✨ Features

Feature	What it does
📈 Overview Dashboard	KPIs, daily activity charts, cost trends, model distribution, weekly heatmap
📋 Sessions Browser	Virtual-scrolled table with sorting, filters (date, model, project, cost), column toggles
🔍 Session Detail	Message-by-message timeline, tool breakdown, cost waterfall
🎯 Advanced Timeline	Gantt-style visualization with swim lanes, zoom, minimap, click-to-inspect
📡 Live Monitor	Real-time per-session tracking via SSE with session switching and message feed
🤖 Interactive Agent	Run Claude Code sessions from the dashboard (requires `ANTHROPIC_API_KEY`)
💰 Cost Analytics	Per-model and per-day breakdowns with 30-day linear forecast
⚡ Cache Efficiency	Hit rates, savings breakdown, token flow visualization, caching recommendations
🛠️ Tool & Skill Usage	Invocation counts, error rates, frequency tables, time-range filtering
🧠 AI Insights	10 automated detection rules (cost spikes, tool loops, context bloat, error cascades)
ℹ️ Info Tooltips	Every metric includes an explanatory tooltip
🎨 Themes	Dark, light, and high-contrast with system preference detection
🔒 Privacy First	Network guard, PII detection, privacy mode, localhost-only

🖥️ CLI Options

Option	Default	Description
`--dir <path>`	`~/.claude`	Directory to scan for Claude sessions
`--port <number>`	`3838`	Server port
`--no-open`	—	Don't auto-open browser
`--privacy-mode`	`true`	Enable PII redaction on API responses

🔒 Security & Privacy

Claude Code Dashboard is built with a zero-trust architecture. Security is enforced at every layer.

🛡️ Network Isolation

A network guard monkey-patches net.Socket.prototype.connect at startup to block all non-localhost outbound connections at the socket level. Runs before any other code. If any dependency tries to phone home — blocked and logged.

Allowed hosts: 127.0.0.1, localhost, ::1, 0.0.0.0

🔐 PII Detection & Redaction

A regex-based scanner detects sensitive data before it reaches the browser:

Category	Patterns
🔑 API keys	Anthropic (`sk-ant-`), OpenAI (`sk-`), generic (`pk-`, `rk-`, `ak-*`)
☁️ Cloud credentials	AWS access keys (`AKIA`, `ABIA`, `ACCA`, `ASIA`)
🎟️ Tokens	GitHub (`ghp_`, `gho_`, `ghu_`, `ghs_`, `ghr_*`), JWTs
🔏 Secrets	Private key headers (RSA, EC, DSA)
👤 Personal data	Email addresses, IPv4 addresses

PII redaction runs at three pipeline points:

Indexing — Content previews redacted before SQLite storage
WebSocket — Agent tool inputs redacted before reaching browser
SSE — Live monitor messages redacted before broadcast

✅ Additional Guarantees

Read-only — Never writes to or modifies ~/.claude/
No telemetry — Zero analytics, tracking, or phone-home
Localhost-only — Server binds exclusively to 127.0.0.1
CSP headers — default-src 'self', X-Frame-Options: DENY, X-Content-Type-Options: nosniff
Prepared statements — All SQLite queries are parameterized (no string interpolation)

🏗️ Architecture

┌──────────────────────────────────────────┐
│  CLI (packages/cli)                      │
│  Commander.js → starts server            │
└────────────────┬─────────────────────────┘
                 │
┌────────────────▼─────────────────────────┐
│  Server (apps/server)                    │
│  Fastify 5 + better-sqlite3 + SSE + WS  │
│                                          │
│  ┌─────────┐ ┌─────────┐ ┌───────────┐  │
│  │ Indexer  │ │  Live   │ │   Agent   │  │
│  │ (JSONL→  │ │ (SSE    │ │ (WS +     │  │
│  │  SQLite) │ │  poll)  │ │  SDK)     │  │
│  └─────────┘ └─────────┘ └───────────┘  │
└────────────────┬─────────────────────────┘
                 │
┌────────────────▼─────────────────────────┐
│  Web (apps/web)                          │
│  Vue 3 + Pinia + ECharts + TanStack     │
└──────────────────────────────────────────┘

Shared packages:
  shared-types/     Zod schemas, TypeScript types
  cost-engine/      Token pricing tables, cost calculator
  session-parser/   JSONL reader, session & timeline builders
  insights-engine/  10 detection rules for session analysis

⚙️ Tech Stack

Layer	Technology
🖼️ Frontend	Vue 3, TypeScript, Vite, Pinia, SCSS (BEM)
📊 Charts	ECharts (tree-shaken)
📋 Tables	TanStack Vue Table + Vue Virtual
🔧 Backend	Fastify 5, better-sqlite3 (WAL mode)
📡 Real-time	Server-Sent Events (live), WebSocket (agent)
🤖 Agent	Claude Agent SDK (`@anthropic-ai/claude-agent-sdk`)
✅ Validation	Zod schemas as single source of truth
💻 CLI	Commander.js
🧪 Testing	Vitest

📁 Project Structure

claude-code-insights/
├── apps/
│   ├── server/           # Fastify API server
│   │   ├── src/
│   │   │   ├── db/       # SQLite schema, queries, connection
│   │   │   ├── middleware/# Network guard, privacy, PII detector
│   │   │   ├── routes/   # REST API, SSE, WebSocket endpoints
│   │   │   ├── services/ # Indexer, scanner
│   │   │   └── workers/  # Session parse worker
│   │   └── package.json
│   └── web/              # Vue 3 SPA
│       ├── src/
│       │   ├── components/# 60+ Vue components
│       │   ├── composables/# Vue composables (API, charts, etc.)
│       │   ├── pages/    # Route-level page components
│       │   ├── stores/   # Pinia state management
│       │   └── styles/   # SCSS design tokens, mixins, themes
│       └── package.json
├── packages/
│   ├── shared-types/     # Zod schemas + TypeScript types
│   ├── cost-engine/      # Token pricing & cost calculation
│   ├── session-parser/   # JSONL parsing & session building
│   ├── insights-engine/  # Automated analysis rules
│   └── cli/              # CLI entry point (npx target)
├── scripts/              # Build scripts
└── docs/                 # Design & implementation plans

🤖 Agent Feature

The interactive Agent page lets you run Claude Code sessions directly from the dashboard. Optional — requires an ANTHROPIC_API_KEY.

export ANTHROPIC_API_KEY=sk-ant-...
npx claude-code-insights

Security: The API key is read by the Claude Agent SDK only — never read, stored, or logged by CSI. Agent communication uses WebSocket over localhost. Tool inputs are PII-redacted.

🔧 Configuration

Environment Variable	Default	Description
`CSI_SCAN_DIR`	`~/.claude`	Directory to scan for sessions
`CSI_PORT`	`3838`	Server port
`CSI_PRIVACY_MODE`	`true`	Enable PII redaction
`ANTHROPIC_API_KEY`	—	Optional. Required only for Agent

🛠️ Development

Prerequisites

Node.js >= 20
pnpm >= 9

Setup

git clone https://github.com/yahav10/claude-code-insights.git
cd claude-code-insights
pnpm install

Commands

pnpm dev              # Dev servers (API :3838, web :5173)
pnpm test             # Run all tests
pnpm typecheck        # Type check
bash scripts/build.sh # Production build

❓ FAQ

Where is my data stored?

Session data is indexed into a local SQLite database at ~/.cache/claude-code-insights/index.db. No data is transmitted anywhere.

Does this modify my Claude Code sessions?

No. CSI is strictly read-only — it never writes to ~/.claude/.

How do I reset the index?

Delete the database file: rm ~/.cache/claude-code-insights/index.db. It will be rebuilt on next start.

Does the Agent feature cost money?

Yes — it calls the Anthropic API using your key. Costs depend on the model and tokens consumed. Same as using Claude Code directly.

Can I run this on a remote server?

No. The server binds to 127.0.0.1 only and the network guard blocks all non-localhost connections. Designed exclusively for local use.

🔧 Troubleshooting

Issue	Solution
No sessions found	Make sure you've used Claude Code at least once. Sessions are in `~/.claude/projects/`. Use `--dir` for custom location
Port already in use	Use `--port <number>`: `npx claude-code-insights --port 4000`
Agent not working	Ensure `ANTHROPIC_API_KEY` is set in your environment
pnpm install fails	Add `"pnpm": { "onlyBuiltDependencies": ["better-sqlite3"] }` to package.json, then re-run. Or use `npx` which handles native builds

🤝 Contributing

See CONTRIBUTING.md.

🔒 Security

See SECURITY.md for our security policy and how to report vulnerabilities.

📜 Code of Conduct

See CODE_OF_CONDUCT.md.

📄 License

MIT — see LICENSE.

Built with ❤️ for the Claude Code community

See what your AI coding sessions actually look like.

Name		Name	Last commit message	Last commit date
Latest commit History 29 Commits
apps		apps
docs		docs
packages		packages
scripts		scripts
tests		tests
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.base.json		tsconfig.base.json
vitest.config.ts		vitest.config.ts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

📊 Claude Code Dashboard

⚡ Quick Start

✨ Features

🖥️ CLI Options

🔒 Security & Privacy

🛡️ Network Isolation

🔐 PII Detection & Redaction

✅ Additional Guarantees

🏗️ Architecture

⚙️ Tech Stack

📁 Project Structure

🤖 Agent Feature

🔧 Configuration

🛠️ Development

Prerequisites

Setup

Commands

❓ FAQ

🔧 Troubleshooting

🤝 Contributing

🔒 Security

📜 Code of Conduct

📄 License

About

Uh oh!

Releases 1

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

📊 Claude Code Dashboard

⚡ Quick Start

✨ Features

🖥️ CLI Options

🔒 Security & Privacy

🛡️ Network Isolation

🔐 PII Detection & Redaction

✅ Additional Guarantees

🏗️ Architecture

⚙️ Tech Stack

📁 Project Structure

🤖 Agent Feature

🔧 Configuration

🛠️ Development

Prerequisites

Setup

Commands

❓ FAQ

🔧 Troubleshooting

🤝 Contributing

🔒 Security

📜 Code of Conduct

📄 License

About

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages