Skip to content
Taveras Solutions · Go to home
Book a diagnostic

MITRaspberry Pi

claude-dashboard

Live Claude Code token usage on a small Raspberry Pi screen.

A physical dashboard that shows the active session, today's estimated spend, and a 30-minute sparkline. Clawd, the Claude Code mascot, jumps on every new prompt and throws particles when tokens grow.

Stars
4
Forks
1
Language
Raspberry Pi
License
MIT

THE PROBLEM

Claude Code usage lives in JSONL files nobody looks at while working. This dashboard makes it visible on the desk.

Who it's for

Daily Claude Code users who want to see their usage without opening another window, and makers with a Raspberry Pi and an SPI screen.

WHAT IT DOES

  • Reads Claude Code session transcripts from ~/.claude/projects.
  • Identifies the active session from history.jsonl, the same source /resume uses.
  • Estimates cost per model from an editable pricing table.
  • Animations that react to real events: a new prompt, growing tokens, or idle time.
  • Draws straight to the /dev/fb1 framebuffer in RGB565, with no X server.
  • A systemd service so it starts on its own.

How it's built

  1. Collector collector.py reads session JSONL and history.jsonl and computes tokens and cost.
  2. Render render.py splits the static layer from the animated one to draw each frame in about 15 ms on a Pi 4.
  3. Display dashboard.py writes to /dev/fb1, the Waveshare 3.5" LCD with an ST7796S controller.
  4. Startup A systemd user service brings it up when the Pi boots.

Stack

PythonRaspberry PiClaude

Getting started

git clone https://github.com/eriktaveras/claude-dashboard.git && cd claude-dashboard
python3 -m pip install -r requirements.txt
python3 dashboard.py  # or --png /tmp/preview.png for a single frame
cp claude-dashboard.service ~/.config/systemd/user/ && systemctl --user enable --now claude-dashboard.service

Need something like this built for you?

We use these same tools in our client projects.