machealth — macOS System Health Checker
Run a one-shot health assessment:
!machealth --human 2>&1 || echo "machealth not installed — brew install lu-zhengda/tap/machealth"
Analyze the output above. Report the overall health score and status (green/yellow/red). Flag any subsystems that are degraded or critical. Offer to run machealth diagnose --human for actionable recommendations or machealth watch --human for continuous monitoring.
Commands
| Command | Purpose | Example |
|---|---|---|
machealth | One-shot health assessment (JSON) | machealth |
machealth check | Same as default (explicit) | machealth check |
machealth --human | Human-readable health report | machealth --human |
machealth diagnose | Health check with actionable recommendations (JSON) | machealth diagnose |
machealth diagnose --human | Human-readable diagnose output | machealth diagnose --human |
machealth watch | Continuous monitoring (JSON Lines) | machealth watch --interval 10s |
machealth watch --human | Live terminal dashboard | machealth watch --human |
Monitored Subsystems
| Subsystem | Weight | Metrics |
|---|---|---|
| CPU | 20% | Load averages, per-core utilization |
| Memory | 25% | Memory pressure, swap usage |
| Thermal | 20% | CPU speed limit, throttling detection |
| Disk | 15% | Available space, usage percentage |
| Battery | 10% | Charge level, power source, health |
| iCloud | 5% | Sync status |
| Network | 5% | Reachability, active interface |
| Time Machine | 0% | Backup state (informational only) |
Exit Codes
| Code | Status | Score Range |
|---|---|---|
| 0 | Healthy (green) | 80-100 |
| 1 | Degraded (yellow) | 50-79 |
| 2 | Critical (red) | 0-49 |
JSON Output
All commands output JSON by default. Use --human for human-readable format:
machealth # JSON output
machealth --human # Human-readable output
machealth diagnose # JSON with recommendations
machealth diagnose --human # Human-readable recommendations
Safety Guidelines
- Read-only: All commands are non-destructive — they only read system metrics
- Low overhead: Health checks are lightweight and safe to run frequently
- Watch mode: Continuous monitoring exits cleanly on Ctrl+C