The claude-dashboard is a powerful local web interface for monitoring Claude Code sessions. It features live monitoring, session history, usage charts, and quick resume commands, providing in-depth analysis of LLM usage. Designed for developers on macOS, it ensures secure and efficient session management with user-friendly data visualization.
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:
- Concurrent sessions in the same directory may not be differentiated, leading to potential confusion.
- Subagent transcripts are not included in statistics and usage counts.
- 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.
No comments yet.
Sign in to be the first to comment.