diagnosing-macos-disk-cpu-and-memory-usagelisted
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