archeious/claude-gauge
1
0
Fork 0
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions
claude-gauge/README.md
Jeff Smith a683828e6b Initial scaffold 
Project skeleton for claude-gauge: a hardware instrument cluster and
companion web dashboard driven by a local Python daemon that tails
~/.claude/projects/**/*.jsonl.

Includes:
- PLAN.md with cluster layout, dashboard sections, architecture,
  metrics brainstorm, and phasing.
- README.md overview.
- Python package scaffold (src/claude_gauge), pyproject.toml
  targeting Python 3.12+ and uv, MIT LICENSE, standard gitignore.

No runtime code yet. Phase A (daemon MVP) will land under the
first issue.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 19:01:30 -06:00

696 B
Raw Blame History

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 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.