archeious/claude-gauge
1
0
Fork 0
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions
Instrument cluster and dashboard for Claude Code session telemetry.
4 commits 2 branches 0 tags 12 MiB
Python 100%
Find a file
Jeff Smith 1bfe151baf chore: add CLAUDE.md for session 1 
Repo-level CLAUDE.md captures current project state (pre-Phase-A,
architecture decision open, PR #2 in flight), project conventions,
where things live, and the session 1 log pointing at the wiki
retrospective.
2026-04-17 21:07:37 -06:00
docs/images Add monitor-dash render to README; prepare wiki layout 2026-04-17 19:31:02 -06:00
src/claude_gauge Initial scaffold 2026-04-17 19:01:30 -06:00
tests Initial scaffold 2026-04-17 19:01:30 -06:00
.gitignore Add monitor-dash render to README; prepare wiki layout 2026-04-17 19:31:02 -06:00
.python-version Initial scaffold 2026-04-17 19:01:30 -06:00
CLAUDE.md chore: add CLAUDE.md for session 1 2026-04-17 21:07:37 -06:00
LICENSE Initial scaffold 2026-04-17 19:01:30 -06:00
PLAN.md Flesh out PLAN.md with two-architecture implementation detail 2026-04-17 19:18:59 -06:00
pyproject.toml Initial scaffold 2026-04-17 19:01:30 -06:00
README.md Add monitor-dash render to README; prepare wiki layout 2026-04-17 19:31:02 -06:00

README.md

claude-gauge

Hardware instrument cluster displaying Claude Code session telemetry in real time.

Monitor-mounted cluster with four gauges and annunciator row

Four analog needle gauges (5h fuel, tokens/min tach, thinking ratio, cache hit) plus an annunciator row of model-indicator and warning lamps, driven by an ESP32 polling a local Python daemon. The daemon reads either Claude Code's native OpenTelemetry feed through a Prometheus stack (architecture A) or ccusage CLI aggregates with a direct JSONL tail for the tach (architecture B). Firmware and cluster are identical across both.

Fighter-jet / race-car aesthetic. Physical-first: the deep stats live in Grafana (A) or ccusage (B); the dial on the desk is the ambient summary.

Documentation

Full documentation is in the wiki:

  • Home — overview and cluster at a glance
  • Architecture — two-architecture tradeoff, daemon contract
  • DataSources — Docker Compose + PromQL (A), ccusage + watchdog (B)
  • Hardware — X27.168 steppers, ESP32 wiring, firmware, enclosure
  • Roadmap — phases, shipped, deferred
  • Ideas — exotic enclosure variants, metrics brainstorm, parked thoughts

Working notes live in PLAN.md. Session records and in-flight thinking happen there; the wiki is the curated surface.

Status

Scaffolded. Phase A pending architecture decision.