Zum Inhalt springen
TakoAPI
Zurück zu den Skills

pi-health

von josunlp

DevOps & Cloud
1.0kDownloadzahlen laut clawskills.sh
0Aufrufe
0 LikesMelde dich an, um diesen Skill zu liken
—Noch nicht bewertet
Deine Bewertung

Kurzbeschreibung

Raspberry Pi health monitor.

Beschreibung

Was dieser Skill macht

Runs a shell script that checks the health of a Raspberry Pi by reading CPU temperature, throttling flags, voltage levels, memory and disk usage, fan RPM, load averages, and overclock settings. Works on Pi 3, 4, and 5 running Raspberry Pi OS Bookworm or later. Returns exit codes 0, 1, or 2 to indicate healthy, warning, or critical states.

Consolidates a dozen separate vcgencmd and sysfs queries into a single script with structured exit codes, making it easy to integrate into cron jobs or monitoring pipelines.

Wann du ihn einsetzt

  • Checking if a Pi is thermally throttling under load
  • Diagnosing under-voltage issues from a weak power supply
  • Verifying system stability before a long-running job
  • Monitoring fan operation on a Pi 5 with active cooling
  • Detecting unauthorized overclocking on a shared Pi

Beispiel-Workflow

EINGABE

User runs: bash scripts/health.sh

AGENT
  1. 1

    Reads CPU temperature from thermal_zone0

  2. 2

    Calls vcgencmd get_throttled to check throttling and under-voltage flags

  3. 3

    Reads memory and disk usage via free and df

  4. 4

    Checks fan RPM from hwmon sysfs and CPU frequency from cpufreq sysfs

  5. 5

    Reads load average from /proc/loadavg and scans dmesg for power warnings

AUSGABE

Prints a health summary table with warning/critical annotations and exits with code 0 (healthy), 1 (warnings), or 2 (critical)

Installation

clawhub install josunlp/pi-health

Führe den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.

Links