Claude Code Dashboard

Claude Code Dashboard

A lightweight localhost dashboard that monitors multiple Claude Code sessions in real-time. See token usage, costs, active tools, subagents, and session status across all your terminal instances at a glance.


Why?

Claude Code has no cross-session visibility. If you're running two or more sessions in separate terminals, you have to alt-tab to check status, there's no combined token/cost view, and you can't see which session is active vs idle.

This dashboard fixes that.

Features

• Live session monitoring — auto-detects all Claude Code sessions
• Token and cost tracking — per-session and combined totals, with correct per-model pricing
• Status detection — thinking (green), waiting (yellow), idle (grey/orange), stale (dimmed)
• Context window usage — visual progress bar per session
• Active subagents — see spawned subagents while they're running
• Active files — see which files each session is working on
• Recent log feed — expandable per-session activity log
• Click to open — click a project name to open its folder
• Git branch display — see which branch each session is on
• Permission mode badges — YOLO and AUTO-EDIT indicators
• Cross-platform — Windows, macOS, and Linux

Quick Start

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

Open **http://localhost:3001** in your browser.

That's it. The dashboard will automatically detect any running Claude Code sessions.

Run this in a separate terminal tab — your Claude Code sessions run in their own terminals as normal, and the dashboard monitors them all from one place.

How It Works

Claude Code writes JSONL session logs to `~/.claude/projects/`. The dashboard:

1. Watches those files for changes using chokidar
2. Parses new lines as they're appended (tail behaviour)
3. Serves aggregated session sta