# Sys Health

> Sys Health

- Skill: `trac3r00/sys-health` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add trac3r00/sys-health`
- Raw SKILL.md: https://api.skillmd.com/api/skills/trac3r00/sys-health/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: trac3r00 (https://skillmd.com/u/trac3r00)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/trac3r00/sys-health

---


# Sys Health

The "is this box okay" check an agent should run before blaming code.

## Commands

```bash
python3 scripts/sys_health.py
python3 scripts/sys_health.py --json --top 10
python3 scripts/sys_health.py --max-disk-pct 90 --max-mem-pct 85   # gate
```

## Reports

| Metric | Source |
|---|---|
| Disk total/used/% | statvfs |
| Memory total/used % | vm_stat (macOS) or /proc/meminfo (Linux) |
| Load 1/5/15m | sysctl vm.loadavg or /proc/loadavg |
| Top N processes by CPU | ps |
| Zombie processes | ps state Z |

Exit 1 when any `--max-*-pct` budget is exceeded or zombies exist.

## Pairs with

`session-finder` (which agents are consuming that CPU),
`net-probe` (the network side of the same triage),
`log-analyzer` (what the box's logs say after you learn it's resource-starved).