archeious/claude-gauge
1
0
Fork 0
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions

Flesh out PLAN.md with two-architecture implementation detail #2

Open
archeious wants to merge 3 commits from feat/1-flesh-out-plan into main
pull from: feat/1-flesh-out-plan
merge into: archeious:main
Conversation 0 Commits 3 Files changed 6 +721 -293
2 changed files with 721 additions and 293 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files
Showing only changes of commit 08eaa63300 - Show all commits

978
PLAN.md
View file

File diff suppressed because it is too large Load diff

36
README.md
View file

@ -1,19 +1,31 @@
# claude-gauge # claude-gauge
Hardware instrument cluster plus companion web dashboard for Claude Hardware instrument cluster displaying Claude Code session telemetry.
Code session telemetry.
A local Python daemon tails `~/.claude/projects/**/*.jsonl`, parses Three analog needle gauges (5h fuel, tokens/min tach, 7d fuel) plus
structured events into rolling windows and aggregate stats, and an annunciator row of model-indicator and warning lamps, driven by
exposes them over HTTP. An ESP32 or Pi Pico drives a three-gauge an ESP32 polling a local Python daemon. The daemon reads either
analog cluster on the desk (tokens/min tach, 5h fuel, 7d fuel) with Claude Code's native OpenTelemetry feed through a Prometheus stack
an annunciator row of model and warning lamps. A browser dashboard (architecture A) or `ccusage` CLI aggregates with a direct JSONL
on the same port surfaces the deep stats. tail for the tach (architecture B). Firmware and cluster are
identical across both.
See [PLAN.md](PLAN.md) for architecture, the instrument cluster Fighter-jet / race-car aesthetic. Physical-first: all the deep
layout, the dashboard sections, the full metrics brainstorm, and stats live in Grafana (A) or ccusage's own surfaces (B). The dial
the phasing plan. on the desk is the ambient summary.
See [PLAN.md](PLAN.md) for:
* Instrument cluster layout and annunciator semantics
* Architecture A: Docker Compose stack, Claude Code env config,
PromQL queries, daemon sketch
* Architecture B: ccusage subprocess integration, watchdog tail,
daemon sketch
* Hardware: X27.168 steppers, SwitecX25 library, ESP32 wiring,
enclosure notes
* Six-phase plan from daemon MVP through enclosure V1
* Full metrics brainstorm for later phases
## Status ## Status
Scaffolded. Phase A (daemon MVP) is the first issue. Scaffolded. Phase A pending architecture decision and first issue.