← Back to Skills Marketplace
158
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install macvital
Description
Check macOS hardware health: CPU usage, RAM pressure, disk space, temperatures, and top processes. Returns a quick status summary or full breakdown. USE WHEN...
README (SKILL.md)
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
# 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
| Metric | Warn | Critical |
|---|---|---|
| CPU | 70% | 90% |
| RAM | 75% | 90% |
| Disk | 80% | 90% |
| Temp | 80°C | 95°C |
Typical Use (agent workflow)
# 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
Usage Guidance
This skill appears to do exactly what it claims: local macOS health checks using standard system commands, with no network calls or credential access. Things to consider before installing: (1) the script may require sudo to show die temperatures — it will prompt for a password if run interactively; (2) the code uses subprocess for shell commands (some with shell=True). That is fine for fixed commands, but avoid passing untrusted input into CLI args to prevent injection; the author-supplied CLI appears safe, but be cautious if you plan to call the script programmatically with user-supplied strings. (3) There is a minor bug in RAM percentage calculation that may produce incorrect RAM% — treat numeric thresholds with caution. (4) The skill has no homepage and an unknown owner; if you will rely on it long-term, consider auditing the full file (scripts/macvital.py) locally or running it in a controlled environment first. Otherwise it is coherent and proportionate for its purpose.
Capability Analysis
Type: OpenClaw Skill
Name: macvital
Version: 1.0.1
The macvital skill is a macOS system health monitor that provides CPU, RAM, disk, and temperature metrics using standard system utilities like top, vm_stat, and powermetrics. While the get_disk function in scripts/macvital.py contains a potential shell injection vulnerability because it passes a path string directly to a shell-enabled subprocess call, this functionality is not exposed to user input via the command-line interface. The skill's behavior aligns perfectly with its documentation and lacks any indicators of malicious intent, data exfiltration, or persistence.
Capability Assessment
Purpose & Capability
Name/description match behavior: the script runs macOS system utilities (top, vm_stat, sysctl, df, ioreg, powermetrics, ps) to collect CPU, RAM, disk, temperature, and process info. There are no unrelated binaries, env vars, or external services required.
Instruction Scope
SKILL.md instructs only to run the bundled script and documents the commands. The script only executes local system commands and prints results. Note: the script calls 'sudo powermetrics' for die temps (documented) and uses subprocess with shell=True for some fixed command strings; if callers pass untrusted input into those string commands (e.g., arbitrary text injected into the 'n' parameter), shell injection risk could arise. Also there is a bug in RAM percentage math (used_pct calculation multiplies by 1024**3 unnecessarily) that may misreport RAM percent.
Install Mechanism
No install spec; skill is instruction + script only. Nothing is downloaded or written to disk by an installer step.
Credentials
No environment variables, credentials, or config paths are requested. The optional need for sudo to read die temperatures is reasonable and documented.
Persistence & Privilege
Skill is not always-enabled and does not request persistent presence or modify other skills/system settings. It runs ad-hoc when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install macvital - After installation, invoke the skill by name or use
/macvital - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
macvital 1.0.1
- Internal update: scripts/macvital.py modified.
- No user-facing changes documented.
v1.0.0
Initial release of macvital – macOS hardware health monitor.
- Provides quick status summaries or detailed breakdowns of CPU, RAM, disk, and temperature usage.
- Shows top processes by CPU or RAM usage.
- Offers thresholds for warning/critical states for all key metrics.
- Supports both human-friendly and machine-readable outputs.
- Includes commands for single checks, continuous monitoring, and workflow integration before heavy tasks.
Metadata
Frequently Asked Questions
What is Macvital?
Check macOS hardware health: CPU usage, RAM pressure, disk space, temperatures, and top processes. Returns a quick status summary or full breakdown. USE WHEN... It is an AI Agent Skill for Claude Code / OpenClaw, with 158 downloads so far.
How do I install Macvital?
Run "/install macvital" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Macvital free?
Yes, Macvital is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Macvital support?
Macvital is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Macvital?
It is built and maintained by wrentheai (@wrentheai); the current version is v1.0.1.
More Skills