explaingit

heyuehuan/dashboard-for-claude-code

Analysis updated 2026-05-18

4PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A local, read only web dashboard that turns your own Claude Code session logs into charts of cost, token usage, tools, and activity patterns.

Mindmap

mindmap
  root((dashboard-for-claude-code))
    What it does
      Reads local Claude Code logs
      Builds a private dashboard
      Never sends data out
    Tech stack
      Python
      FastAPI
      SQLite
    Use cases
      Track cost by project
      See tool and skill usage
      View activity heatmap
    Audience
      Developer
    Setup
      Run with uvx or pipx
      Requires Python 3.11+
      Needs existing Claude Code logs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

See which projects and sessions are costing the most Claude Code usage.

USE CASE 2

Check when during the day and week you actually use Claude Code the most.

USE CASE 3

Find out which tools and skills get invoked and which never do.

USE CASE 4

Spot sessions with high churn, errors, or repeated retries.

What is it built with?

PythonFastAPISQLite

How does it compare?

heyuehuan/dashboard-for-claude-code1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedevelopervibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3.11+ and an existing ~/.claude/projects/ directory created by Claude Code.

MIT license, use freely for any purpose including commercial use as long as you keep the copyright notice.

In plain English

Dashboard for Claude Code is a local analytics tool for anyone who uses Claude Code, the terminal based coding assistant. It reads the session logs that Claude Code already saves on your own computer and turns them into a private web dashboard showing how you actually use the tool, without sending any of that data anywhere else. Once running, it answers questions a person could not easily answer by hand, such as which projects get the most use, which sessions cost the most, what time of day the tool gets used most, which tools and skills actually get invoked, and whether a person's working style leans more supervised or autonomous. It shows this through an overview page with headline numbers, a daily cost chart, a breakdown of token usage by model, a heatmap of activity by weekday and hour, a calendar style week view of sessions color coded by project, and a searchable list of individual sessions with details like duration, tokens used, tools called, and code changes. Under the hood, Claude Code writes a log file for every session on disk. This project scans those files, which it never modifies, pulls out the relevant numbers, and stores them in a small local database so that later scans only need to look at files that changed since last time. A lightweight local web server then serves the dashboard from that database. It can be started with a single command using tools like uvx or pipx, without a separate install step, or set up more permanently with the uv package manager. By default it only listens on the machine it runs on, though it can optionally be exposed to other devices on the same local network, with an optional access token for that case. It requires Python 3.11 or newer and an existing Claude Code installation, and is released under the MIT license. It is an independent community project, not made or endorsed by Anthropic.

Copy-paste prompts

Prompt 1
Set up and run this dashboard on my machine, reading the local Claude Code session logs.
Prompt 2
Explain how this dashboard estimates API cost per model from token usage in session logs.
Prompt 3
Show me how to expose this local dashboard to other devices on my network safely with an access token.
Prompt 4
Help me understand what the activity heatmap and autonomy profile charts are telling me about my usage.

Frequently asked questions

What is dashboard-for-claude-code?

A local, read only web dashboard that turns your own Claude Code session logs into charts of cost, token usage, tools, and activity patterns.

What language is dashboard-for-claude-code written in?

Mainly Python. The stack also includes Python, FastAPI, SQLite.

What license does dashboard-for-claude-code use?

MIT license, use freely for any purpose including commercial use as long as you keep the copyright notice.

How hard is dashboard-for-claude-code to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is dashboard-for-claude-code for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.