pi-health

Verified·Scanned 2/18/2026

Raspberry Pi health monitor. Check CPU temperature, throttling status, voltage levels, memory/disk usage, fan RPM, overclock detection, and power issues. Use when monitoring Pi health, diagnosing thermal throttling, checking for under-voltage, or verifying system stability on any Raspberry Pi (Pi 3/4/5, arm64/armhf).

from clawhub.ai·vfed7e96·8.3 KB·0 installs
Scanned from 1.0.0 at fed7e96 · Transparency log ↗
$ vett add clawhub.ai/josunlp/pi-health

Pi Health

Run the health check script:

bash scripts/health.sh

What It Checks

CheckSourceWarningCritical
CPU Temperaturethermal_zone0>70°C>80°C
Throttlingvcgencmd get_throttledany flag setunder-voltage
Voltagesvcgencmd measure_volts
Memoryfree -m>75%>90%
Diskdf />75%>90%
CPU Frequencycpufreq sysfs
Load Average/proc/loadavg>nCPU>2×nCPU
Fanhwmon sysfs
Overclockconfig.txtdetected
Powerdmesgunder-voltage

Exit Codes

  • 0 — Healthy (all checks passed)
  • 1 — Warnings (non-critical issues)
  • 2 — Critical (needs immediate attention)

Requirements

  • Raspberry Pi OS (Bookworm or later)
  • vcgencmd (optional but recommended — comes with libraspberrypi-bin)
  • bc (standard on Pi OS)
  • No external dependencies or API keys