# mainskeeper CLI — PROPOSED product contract, not shipped software. Fictional demonstration data.
# screen: doctor-perm · host: lab-pi · 80 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): 11, 12, 13, 14, 20
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)
