← ClaudeAtlas

diagnosing-macos-disk-cpu-and-memory-usagelisted

Diagnose macOS disk space, CPU and memory use with bounded read-only scans. Use for what's using my CPU or RAM, high memory pressure, swap growth, large caches, or APFS sizes that differ from free space.
sblattj/agent-chandlery · ★ 0 · AI & Automation · score 72
Install: claude install-skill sblattj/agent-chandlery
# Diagnose macOS resource use Find which processes and directories account for current resource use. Read the system and requested paths; write diagnostic artifacts only. Cleanup and process termination require a separate user instruction. ## Do this From this skill's directory: ```bash python3 scripts/scan_macos_resource_usage.py --disk-root "$HOME" ``` Use an absolute helper path when running from another directory. Narrow `--disk-root` to the area the user asked about; repeat it for distinct roots. Use `--skip-disk` for CPU and memory only. The helper prints the artifact directory and progress, with a default 120-second command budget and 15 seconds per disk partition. `--out`, `--deadline-seconds`, `--per-root-seconds` and `--max-entries` override those limits. Root planning and enumeration check the deadline between filesystem operations; an individual metadata call can still wait on its filesystem. Read `report.json` and the relevant raw command outputs. Tell the user which measurements completed, which are partial or unknown, and the largest observed contributors. If a large root times out, narrow the next scan to a specific child; retain the first result instead of repeating the same full traversal. ## Interpret the evidence - **CPU:** use the second `top` sample for interval usage; a single initial sample can show misleading zeroes. Separate load average, total CPU use and individual process percentages. Use PID, parent PID, elapsed time and command arguments