Metadata-Version: 2.4
Name: shervinsights
Version: 0.1.0
Summary: Read-only Mac/Linux triage CLI for debugging interviews and SadServers-style scenarios.
Author: Shervin Ghasemlou
License: MIT
Project-URL: Homepage, https://github.com/shervinghasemlou/shervinsights
Project-URL: Repository, https://github.com/shervinghasemlou/shervinsights
Keywords: linux,bash,debugging,triage,sre,interview,sadservers
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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

```bash
pip install shervinsights
```

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

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

## Usage

```bash
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.
