Cc Lens


Claude Code Lens (cc-lens)

Local analytics dashboard for Claude Code. No cloud, no telemetry, no API key, just your `~/.claude/` data, visualized.

npx cc-lens

The CLI finds a free local port, starts the dashboard, and opens it in your browser.

Quick Start

Run directly with `npx`:

npx cc-lens

On first run, `cc-lens` prepares a small runtime cache in `~/.cc-lens/`. After that, launches are faster.

What You Can See

Overview

• Sessions, messages, token usage, estimated cost, and local storage.
• Trend cards with sparklines.
• Date presets for 7, 30, and 90 days, plus a custom date range picker.
• Usage over time, model distribution, peak hours, project activity, token breakdown, and recent sessions.

Projects


• Searchable, sortable project grid.
• Per-project cards with sessions, duration, estimated cost, languages, git branches, MCP/agent badges, and top tools.
• Project detail pages with sessions, cost over time, language distribution, branch activity, and tool usage.

Sessions


• Searchable session table with badges for compaction, agents, MCP, web search/fetch, and extended thinking.
• Full session replay reconstructed from JSONL.
• Assistant responses rendered as GitHub-flavored Markdown.
• Tool calls and tool results shown inline.
• File read/write/update tool results parsed into readable cards.
• Per-turn model, duration, token breakdown, and estimated cost.
• Compaction events shown in context with a token accumulation chart.

Costs


• Total estimated cost, cache savings, and estimated