# mainskeeper CLI — PROPOSED product contract, not shipped software. Fictional demonstration data.
# screen: doctor-perm · host: lab-pi · 120 columns · NO_COLOR · exit 5
# clock: Wed 30 Sep 2026 15:22 PDT · Illustrative · placeholder host outside the fixture fleet
# stderr lines (counting the prompt line as 1): 8, 9, 13
lab-pi $ mainskeeper doctor
MainsKeeper · lab-pi · doctor                                                                  Wed 30 Sep 2026 15:22 PDT
Checks read state only. Nothing on the UPS or attached equipment is changed.

✓ config        /etc/mainskeeper/collector.toml valid (schema 1)
✓ enrollment    enrolled · valid
✓ service       mainskeeperd.service active (running) since 15:01:37 PDT
✗ USB access    mainskeeperd cannot open /dev/bus/usb/001/004 (APC Back-UPS 600, 051d:0002): permission denied
                device is root:root 0664 — udev rule 60-mainskeeper.rules is missing
▲ your access   user pi is not in group mainskeeper; logs and some checks need it
✓ cloud         ingest.mainskeeper.example reachable (HTTPS, 41 ms)

Result  1 problem, 1 warning · exit 5 (permission denied)

Fix
  › sudo cp /usr/share/mainskeeper/60-mainskeeper.rules /etc/udev/rules.d/
  › sudo udevadm control --reload && sudo udevadm trigger
  › optional, for logs: sudo usermod -aG mainskeeper pi (log in again)
