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.
1 commit 2 branches 0 tags 12 MiB
Python 100%
Find a file
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
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 Initial scaffold 2026-04-17 19:01:30 -06:00
.python-version Initial scaffold 2026-04-17 19:01:30 -06:00
LICENSE Initial scaffold 2026-04-17 19:01:30 -06:00
PLAN.md Initial scaffold 2026-04-17 19:01:30 -06:00
pyproject.toml Initial scaffold 2026-04-17 19:01:30 -06:00
README.md Initial scaffold 2026-04-17 19:01:30 -06:00

README.md

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.