The claude-dashboard is a robust local web dashboard designed for overseeing and managing Claude Code sessions. This tool offers live monitoring, historical data insights, usage analytics, and the ability to quickly resume commands. Here is a detailed overview of its key features:

Key Features

• Live Session Monitoring: Easily track ongoing Claude Code sessions on your machine.
• Session History: Access a comprehensive history of previous sessions.
• Usage Charts: Visualize usage patterns through interactive charts.
• One-Click Resume: Quickly resume commands with a single click, enhancing workflow efficiency.
• On-Demand LLM Usage Analysis: Analyze large language model usage based on detailed report generation.

How It Works

The dashboard operates by reading session transcripts from the local file system at ~/.claude/projects/*/*.jsonl. It detects live sessions by matching claude processes using system commands, with fallback mechanisms to ensure reliability. Additionally, the usage analysis feature can run headless, compiling a digest of the past 14 days and caching results for easy access.

Security Considerations

The server is configured to bind only to 127.0.0.1, ensuring it is not exposed to the broader network. It utilizes a Host allowlist and enforces headers for specific API calls to mitigate risks such as DNS-rebinding attacks.

Limitations

While powerful, the current version has some limitations, including:

1. Concurrent sessions in the same directory may not be differentiated, leading to potential confusion.
2. Subagent transcripts are not included in statistics and usage counts.
3. Data panels only load once per page visit, requiring a manual refresh for updated information.

Running the Dashboard

To deploy the dashboard, the necessary Node.js environment should be set up and the application started using npm. Access the dashboard locally at http://localhost:5173, with the API server available on the designated port.

This utility serves as an essential resource for developers utilizing Claude Code who seek to optimize their coding sessions with real-time insights and management capabilities.