Summary

Claude Code Lens (cc-lens) provides a real-time, local monitoring dashboard for Claude Code analytics, designed for users who prioritize data privacy and local control. It offers a comprehensive overview of token usage, project activity, costs, and conversation history directly from the user's machine, eliminating the need for cloud services or telemetry. This tool benefits power users and developers seeking deep insights into their Claude Code interactions and resource consumption.

How It Works

cc-lens operates by directly reading and parsing data files located in the ~/.claude/ directory. It aggregates information from various JSONL and JSON files, including session data, usage statistics, command history, memory, todos, and settings. The dashboard refreshes data every 5 seconds, presenting a dynamic, real-time view of user activity without sending any data externally.

Quick Start & Requirements

• Primary install/run command: npx cc-lens (no installation required).
• Prerequisites: Node.js 18+ and Claude Code configured with local data stored in ~/.claude/.
• Setup: The npx command automatically finds a free port, starts the server, and opens the dashboard in the browser.
• Local Development: Clone the repository, run npm install, then npm run dev. Build with npm run build and run with npm start.

Highlighted Details

• Comprehensive Analytics: Visualizes token usage over time, project activity distribution, peak hour heatmaps, model breakdowns, and cost analysis per project and session.
• Session & Project Deep Dive: Offers sortable session tables with filters, full session replays, per-project detail pages, and tool usage rankings.
• Data Management: Includes features to browse and edit Claude Code memory files, view and manage todo lists, and read saved plan files with inline markdown rendering.
• Enhanced Navigation: Features a global search command palette (⌘K/Ctrl+K or /) and efficient keyboard navigation (j/k, Enter, Esc, g + letter shortcuts) for rapid data access.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap were found in the provided README.

Licensing & Compatibility

The license type and compatibility notes for commercial use or closed-source linking are not specified in the provided README.

Limitations & Caveats

This tool is specifically designed for Claude Code and relies entirely on the presence and structure of local data within the ~/.claude/ directory. Functionality is dependent on the user's Claude Code setup and data availability.