Generate a concise macOS host resource report focused on local-model readiness and machine pressure. Use when the user asks about Mac resource usage, current...
# mac-system-stat Produce a concise macOS host snapshot using small local helpers. ## Use when - The user asks for current Mac resource usage or machine health - You need CPU, memory, GPU, swap, power, fan, or a short host summary - You want a truthful one-shot report, not continuous monitoring ## Scripts - `scripts/hoststat` — aggregate JSON host snapshot - `scripts/memstat` — RAM / compression / swap / memory pressure - `scripts/cpustat` — CPU usage, load average, process counts, top CPU processes - `scripts/gpustat` — GPU model + live IOAccelerator statistics via local Swift/IOKit helper - `scripts/powerstat` — Apple Silicon IOReport-based power sampler (non-privileged, short window average) - `scripts/fanstat` — AppleSMC-based fan reader (fan count, RPM, min/max, mode) - `scripts/tempstat` — AppleSMC temperature sensors + pmset thermal state (CPU, battery, ambient, board) - `scripts/build-helpers` — prebuild Swift helpers explicitly (optional; normal wrappers auto-build as needed) ## Layout - The skill is intentionally self-contained under `skills/mac-system-stat/` - Python entrypoints, shared Python modules, Swift sources, and compiled helper output all live under `skills/mac-system-stat/scripts/` - `scripts/bin/` is generated locally on first run or via `scripts/build-helpers` ## Release contract - **Chosen contract:** source-only, self-building on first run - Ship the skill directory with Python + Swift sources; do **not** rely on compiled helpers being pre-vendored - `gpustat`, `powerstat`, `fanstat`, and `tempstat` will auto-build their helper binaries into `scripts/bin/` when missing or stale - If `swiftc` / Apple Command Line Tools are unavailable, those four helpers fail truthfully with structured JSON; `memstat` and `cpustat` still run normally - For packaging / ClawHub, exclude transient local artifacts such as `scripts/bin/` contents and `__pycache__/` ## Notes - macOS only; Apple Silicon first - Default path avoids sudo - Prefer helper JSON over hand-written summaries - GPU reads IORegistry properties directly via IOKit instead of parsing `ioreg` text - Power uses IOReport Energy Model deltas; values are short-window averages, not hardware-meter absolutes - Fan RPM comes from AppleSMC F* keys; 0 RPM can mean the fans are currently stopped - Temperature uses curated AppleSMC keys (Tp0P, Tp0T, Te0T, Ts0P, TB0T, TW0P, Ta0P) + pmset therm state - Packaging caveat: compiled helpers are not vendored; the target machine still needs Command Line Tools / `swiftc` for first build unless prebuilt binaries are shipped separately
don't have the plugin yet? install it then click "run inline in claude" again.