A local dashboard for visualizing your Claude Code usage — sessions, token costs, cache performance, tool calls, and daily breakdowns.

• Today vs All-Time stats — sessions, messages, tool calls, estimated cost
• Cache performance — hit rate, savings vs no-cache baseline
• Daily cost & cache table — per-day token breakdown with estimated spend
• Tool call analytics — which tools Claude used most, across all projects
• Configurable pricing — swap between Bedrock and Anthropic API rates via .env

• Node.js 18+
• Claude Code installed (data lives in ~/.claude)

No install needed — run directly from GitHub:

npx github:foyzulkarim/claude-lens

Then open http://localhost:3456. Defaults to ~/.claude if CLAUDE_DIR is not set.

git clone https://github.com/foyzulkarim/claude-lens.git
cd claude-lens
npm install
cp .env.example .env

Edit .env and set CLAUDE_DIR to your Claude data directory (defaults to ~/.claude).

node server.js

Open http://localhost:3456.

All options are set via .env:

Default rates match Bedrock cross-region inference (ap-southeast-2). For Anthropic API rates use RATE_INPUT=15, RATE_OUTPUT=75, RATE_CACHE_READ=1.5, RATE_CACHE_CREATE=18.75.