# claude-gauge

Hardware instrument cluster plus companion web dashboard for Claude
Code session telemetry.

A local Python daemon tails `~/.claude/projects/**/*.jsonl`, parses
structured events into rolling windows and aggregate stats, and
exposes them over HTTP. An ESP32 or Pi Pico drives a three-gauge
analog cluster on the desk (tokens/min tach, 5h fuel, 7d fuel) with
an annunciator row of model and warning lamps. A browser dashboard
on the same port surfaces the deep stats.

See [PLAN.md](PLAN.md) for architecture, the instrument cluster
layout, the dashboard sections, the full metrics brainstorm, and
the phasing plan.

## Status

Scaffolded. Phase A (daemon MVP) is the first issue.