shervinsights 0.1.0

Read-only Mac/Linux triage CLI for debugging interviews and SadServers-style scenarios.

shervinsights

shervinsights is a read-only Mac/Linux triage CLI for debugging interviews and SadServers-style scenarios.

It summarizes likely issues:

• high load
• full disk or inode pressure
• hot CPU or memory-heavy processes
• zombie or D-state processes
• deleted-but-open files
• actively growing logs
• listening ports
• Python / ML / model-serving processes
• Bash syntax errors
• Linux systemd / journal / GPU hints when available

It does not kill processes, delete files, restart services, or modify system state.

Install

pip install shervinsights

For Homebrew-managed Python or other PEP-668 systems, use a virtualenv or pipx:

python3 -m venv ~/.venvs/shervinsights
~/.venvs/shervinsights/bin/pip install shervinsights
~/.venvs/shervinsights/bin/shervinsights --hints

Usage

shervinsights
shervinsights --hints
shervinsights --sample 10 --hints
shervinsights --details disk
shervinsights --details proc
shervinsights --details logs
shervinsights --details ports
shervinsights --details scripts
shervinsights --details ml
shervinsights --details linux

Interview framing

I’ll run a read-only triage pass to identify the failing resource: process, file, port, service, script, disk, or log. Then I’ll inspect the specific PID/file/service manually and make the smallest safe fix.