pi-health
// 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/
$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namepi-health
descriptionRaspberry 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).
Pi Health
Run the health check script:
bash scripts/health.sh
What It Checks
| Check | Source | Warning | Critical |
|---|---|---|---|
| CPU Temperature | thermal_zone0 | >70°C | >80°C |
| Throttling | vcgencmd get_throttled | any flag set | under-voltage |
| Voltages | vcgencmd measure_volts | — | — |
| Memory | free -m | >75% | >90% |
| Disk | df / | >75% | >90% |
| CPU Frequency | cpufreq sysfs | — | — |
| Load Average | /proc/loadavg | >nCPU | >2×nCPU |
| Fan | hwmon sysfs | — | — |
| Overclock | config.txt | detected | — |
| Power | dmesg | — | under-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 withlibraspberrypi-bin)bc(standard on Pi OS)- No external dependencies or API keys