System Doctor (sys-doctor)#

Run comprehensive system diagnostics with a single command.

Quick start#

bash

python3 skills/sys-doctor/scripts/sys_doctor.py

Output example:

text

◆ System Health Report: myserver
2026-05-10 13:30:00
============================================================
========================== DISK ==========================
  🟢 /              60%  (30G/50G, avail: 20G)
  🟡 /var/log       85%  (4.3G/5G, avail: 0.7G)
  🟢 /home          45%  (90G/200G, avail: 110G)
========================== MEMORY ========================
  RAM:    4.2G / 16G  (26%)
  Swap:   0.1G / 2G  (5%)
========================== CPU ============================
  Load:     0.45 / 0.32 / 0.28
  Cores:    4 (8 logical)
========================== NETWORK ========================
  🟢 eth0       UP    192.168.1.100/24
  🟢 docker0    UP    172.17.0.1/16
========================== SERVICES ======================
  • systemd-journald  • cron  • sshd  • docker
  • nginx  • postgresql  • redis-server

Commands#

CommandAction--check diskCheck only disk usage--check memoryCheck only memory/swap--check cpuCheck only CPU load--check networkCheck only network interfaces--check servicesList running services--reportGenerate HTML health report--jsonOutput as JSON--output file.htmlSave to specific file

HTML Reports#

Generate a styled HTML report for sharing or monitoring:

bash

python3 skills/sys-doctor/scripts/sys_doctor.py --report
# Creates: sys-doctor-report-20260510-133000.html

JSON Output#

For programmatic consumption (API, monitoring, dashboards):

bash

python3 skills/sys-doctor/scripts/sys_doctor.py --json

Health Status Logic#

• Disk ≥ 90% → critical (exit code 2)
• Disk ≥ 80% → warning
• Disk < 80% → ok

The report's color-coded badges reflect overall health status.

Requirements#

• Linux (primary) — uses /proc/, df, free, ip, systemctl
• macOS — partial support via psutil fallback (install: pip install psutil)
• No external API calls — fully offline