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
- Collector collector.py reads session JSONL and history.jsonl and computes tokens and cost.
- Render render.py splits the static layer from the animated one to draw each frame in about 15 ms on a Pi 4.
- Display dashboard.py writes to /dev/fb1, the Waveshare 3.5" LCD with an ST7796S controller.
- 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.
Other open source projects
- SaaS starter django-saas-boilerplate A Django 6 SaaS starter: email login, Stripe subscriptions, a dashboard, CSP, and 67 tests. Ready to deploy.
- AI invoicing InvoiceFlow AI invoicing for the Dominican Republic: OCR, DGII tax alerts (ITBIS, dates, 606 data), invoices over WhatsApp, and 606 exports.
- macOS app ModelNap A menu bar app that puts idle local Ollama models to sleep and gives your Mac its memory back. Signed and notarized.