diff --git a/project-kitestacks-migration.md b/project-kitestacks-migration.md index 761b6d2..4773234 100644 --- a/project-kitestacks-migration.md +++ b/project-kitestacks-migration.md @@ -574,6 +574,28 @@ Verification: - Grafana logs show dashboard provisioning completed without dashboard errors (only unrelated bundled plugin permission warnings). +### Desktop widget for the same monitor set (2026-06-15) +User asked for a Rainmeter-like desktop widget on Debian 13 that can show the +same Uptime Kuma monitor state in real time. + +Created a local Conky-based widget scaffold in the desktop user's home: +- `~/.local/bin/kitestacks-uptime-widget.sh` +- `~/.config/conky/kitestacks-uptime.conf` + +Behavior: +- Polls Prometheus for `probe_success` and `probe_duration_seconds` from the +`uptime-kuma-ping-probes` job. +- Defaults to `http://prometheus.kitestacks.com:9090`, with `PROM_URL` + override support. +- Prints the four Kuma monitor names, state, latency, and a summary line. +- Degrades cleanly with `Prometheus unavailable at ...` when the endpoint + cannot be reached. + +Note: Conky is the closest direct Rainmeter-style equivalent for Debian/Linux +desktop widgets; `eww` is the more modern alternative if the desktop session is +Wayland-first and the user prefers GTK/Rust widgets instead of a classic +desktop overlay. + Important security hygiene: local git remote for `~/claude-memory` contains an HTTP token in the URL; do not print it in summaries. Prefer redacted URLs in handoffs.