- Move uploaded renders into docs/images/ (tracked).
- Insert the Monitor Dash render at the top of README.md as the
headline image of the project.
- Rewrite README body to point at the forgejo wiki (six pages now
live) as the canonical documentation surface, with PLAN.md
staying as working notes.
- Gitignore docs/wiki/ so the wiki git checkout does not bleed
into the main repo.
Refs #1
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Expand the planning document to implementation-ready detail. Both
viable data paths are specified independently so either can ship:
- Architecture A (OTEL-native): full docker-compose stack mirroring
Anthropic's claude-code-monitoring-guide (otel-collector on 4317
/ 4318 / 8889, Prometheus on 9090, Grafana on 3000), Claude Code
env vars, PromQL queries for each gauge, Python daemon sketch
that queries Prometheus and serves /usage.
- Architecture B (ccusage-sourced): subprocess invocation of
ccusage CLI for 5h blocks and 7d daily aggregates, watchdog
JSONL tail for sub-second tach responsiveness, Python daemon
sketch with a 60s RateBus ring buffer.
Hardware specified: X27.168 stepper motors driven by the Arduino
SwitecX25 library on ESP32 (Arduino C++ since no MicroPython port
exists), concrete GPIO pin assignments, ULN2003A driver notes,
annunciator LED wiring, enclosure notes.
Also captured: metric schema from Claude Code's OTEL docs,
prior-art review (ccusage / Claude-Code-Usage-Monitor / Grafana
Labs dashboards 25052 and 24993 / Anthropic's monitoring guide),
six-phase delivery plan, comparison table of A vs B, recommendation
(A for homelab-as-enterprise framing), and a metrics brainstorm
for later phases.
README updated to summarise both architectures and point at the
expanded plan.
Refs #1
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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>
