macvital
macOS hardware health monitor. Checks CPU, RAM, disk, temperature, and top resource hogs.
Requirements
- - Python 3 (pre-installed on macOS)
- Script: INLINECODE0
- Temperature data requires
sudo (Apple Silicon only)
Commands
CODEBLOCK0
Thresholds
| Metric | Warn | Critical |
|---|
| CPU | 70% | 90% |
| RAM |
75% | 90% |
| Disk | 80% | 90% |
| Temp | 80°C | 95°C |
Typical Use (agent workflow)
CODEBLOCK1
macvital
macOS 硬件健康监控工具。检查 CPU、内存、磁盘、温度以及资源占用最高的进程。
系统要求
- - Python 3(macOS 预装)
- 脚本:scripts/macvital.py
- 温度数据需要 sudo 权限(仅限 Apple Silicon 芯片)
命令
bash
快速单行状态(良好/警告/严重,带图标显示)
python3 scripts/macvital.py status
python3 scripts/macvital.py status --json # 机器可读格式
完整详细信息
python3 scripts/macvital.py detail
CPU 和内存占用最高的进程
python3 scripts/macvital.py top
python3 scripts/macvital.py top --n 10
仅查看温度(使用 sudo 获取更准确数据)
python3 scripts/macvital.py temp
sudo python3 scripts/macvital.py temp
退出码检查(用于脚本:0=正常,1=警告,2=严重)
python3 scripts/macvital.py check
持续监控
python3 scripts/macvital.py watch
python3 scripts/macvital.py watch --interval 10
阈值
75% | 90% |
| 磁盘 | 80% | 90% |
| 温度 | 80°C | 95°C |
典型用法(代理工作流)
bash
执行繁重任务前
python3 scripts/macvital.py check
退出码 0 = 可以安全执行,退出码 1/2 = 建议等待
快速心跳状态行
python3 scripts/macvital.py status
诊断系统卡顿
python3 scripts/macvital.py detail
python3 scripts/macvital.py top