macvital#

macOS hardware health monitor. Checks CPU, RAM, disk, temperature, and top resource hogs.

Requirements#

• Python 3 (pre-installed on macOS)
• Script: scripts/macvital.py
• Temperature data requires sudo (Apple Silicon only)

Commands#

bash

# Quick one-line status (good/warn/critical with icons)
python3 scripts/macvital.py status
python3 scripts/macvital.py status --json   # machine-readable

# Full breakdown
python3 scripts/macvital.py detail

# Top CPU and RAM processes
python3 scripts/macvital.py top
python3 scripts/macvital.py top --n 10

# Temperature only (more accurate with sudo)
python3 scripts/macvital.py temp
sudo python3 scripts/macvital.py temp

# Exit code check (for scripting: 0=ok, 1=warn, 2=critical)
python3 scripts/macvital.py check

# Continuous monitoring
python3 scripts/macvital.py watch
python3 scripts/macvital.py watch --interval 10

Thresholds#

MetricWarnCriticalCPU70%90%RAM75%90%Disk80%90%Temp80°C95°C

Typical Use (agent workflow)#

bash

# Before a heavy task
python3 scripts/macvital.py check
# exit 0 = safe to proceed, exit 1/2 = consider waiting

# Quick heartbeat line
python3 scripts/macvital.py status

# Diagnosing slowness
python3 scripts/macvital.py detail
python3 scripts/macvital.py top