Claude Code Session Dashboard: Open Source Tool for Monitoring Multiple Sessions

What It Is

Claude Code Session Dashboard is an open-source tool built to solve visibility problems when running multiple Claude Code sessions simultaneously. It provides a combined view of costs, session status, and context window usage across sessions.

How It Was Built

The entire project was written using Claude Code. The developer described the problem, and Claude identified that Claude Code writes JSONL session logs to ~/.claude/projects/. Claude then built the file watcher, Express API, and frontend in a single HTML file.

Features Per Session

• Token usage and cost with correct per-model pricing
• Status indicators: thinking, waiting, idle, or stale
• Context window usage as a visual progress bar
• Active subagents while they're running
• Which files the session is currently working on
• Expandable activity log
• Git branch and permission mode (AUTO-EDIT / YOLO)

How It Works

Claude Code writes JSONL session logs to ~/.claude/projects/. The dashboard watches those files and renders everything in a browser tab. No WebSockets, no build step, no cloud — just Node.js tailing local files and a single HTML file for the UI.

Quick Start

git clone https://github.com/Stargx/claude-code-dashboard
cd claude-code-dashboard
npm install && npm start

Then open http://localhost:3001. The project is free and MIT licensed.

The developer is seeking feedback, especially from users on macOS or Linux who might encounter issues with session detection.