npm package: @12britz/sysview
Description: A beautiful CLI tool for system monitoring - ports, network, memory, CPU, disk with colorful tables
Latest version: 1.0.3

# @12britz/sysview

**A beautiful CLI tool for system monitoring - ports, network, memory, CPU, disk, processes, and git with colorful tables.**

Stop guessing. `sysview` gives you a color-coded overview of your system in seconds.

## Install

```bash
npm install -g @12britz/sysview
```

## What it looks like

### Memory
```
$ sysview memory

┌──────────────────────────────────────────────────┐
│            sysview - memory                       │
└──────────────────────────────────────────────────┘

┌────────────────────┬───────────────┬───────────────┬───────────────┬──────────┐
│ TYPE               │ USED         │ TOTAL         │ FREE          │ USAGE    │
├────────────────────┼───────────────┼───────────────┼───────────────┼──────────┤
│ Physical Memory    │ 16.4 GB      │ 64 GB         │ 47.6 GB       │ 25.6%    │
│ Available          │ 55.8 GB      │ 64 GB         │ -             │ 25.6%    │
└────────────────────┴───────────────┴───────────────┴───────────────┴──────────┘

██████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 25.6%

55.8 GB available
```

![top-sv](https://github.com/user-attachments/assets/1062366f-7bcc-4457-aba3-95657c3dd8fc)


### CPU
```
$ sysview cpu

┌──────────────────────────────────────────────────┐
│            sysview - cpu                         │
└──────────────────────────────────────────────────┘

┌──────────────────────────────┬────────────────────┐
│ METRIC                       │ VALUE              │
├──────────────────────────────┼────────────────────┤
│ Model                        │ Apple M1 Max       │
│ Cores                        │ 10                 │
│ Physical Cores               │ 10                 │
│ Speed                        │ 2.4 GHz            │
│ Current Load                 │ 11.6%              │
│ Running Processes            │ 587                │
└──────────────────────────────┴────────────────────┘

Load: █████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 11.6%

Per-Core Usage:
┌──────────┬──────────────────────────────────────────────────┐
│ CORE 0   │ ███████████████░░░░░░░░░░░░░░░░░░░░░░░░ 38.7%  │
│ CORE 1   │ ███████████████░░░░░░░░░░░░░░░░░░░░░░░░ 38.0%  │
│ CORE 2   │ ██████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 13.9%  │
│ CORE 3   │ ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  9.3%   │
└──────────┴──────────────────────────────────────────────────┘
```

### Ports
```
$ sysview ports

┌──────────────────────────────────────────────────┐
│            sysview - ports                        │
└──────────────────────────────────────────────────┘

┌──────────┬────────────────────┬──────────┬────────────────────┬──────────┐
│ PORT     │ PROCESS           │ PID      │ ADDRESS            │ STATUS   │
├──────────┼────────────────────┼──────────┼────────────────────┼──────────┤
│ :3000    │ node              │ 42872    │ 127.0.0.1          │ ● LISTEN │
│ :5432    │ postgres          │ 99101    │ 127.0.0.1          │ ● LISTEN │
│ :6379    │ redis-server      │ 87321    │ 0.0.0.0            │ ● LISTEN │
└──────────┴────────────────────┴──────────┴────────────────────┴──────────┘

6 ports listening
```

### Dashboard
```
$ sysview dashboard

═══════════════════════════════════════════════════
                    SYSVIEW DASHBOARD
═══════════════════════════════════════════════════
```
![sv](https://github.com/user-attachments/assets/1a3fa289-8bcd-49af-ad32-a59f9fc6cfee)

## Usage

### Commands

| Command | Description |
|---------|-------------|
| `sysview` | Show available commands |
| `sysview ports` | Show listening ports |
| `sysview network` | Show network connections |
| `sysview memory` | Show memory usage |
| `sysview cpu` | Show CPU usage |
| `sysview disk` | Show disk usage |
| `sysview ps` | Show running processes |
| `sysview process` | Show process tree |
| `sysview top` | Interactive process monitor |
| `sysview git` | Git repository info |
| `sysview kill <pid>` | Kill a process |
| `sysview watch` | Real-time dashboard |
| `sysview dashboard` | Full system overview |

### Options

#### ports
```bash
sysview ports
```

#### network
```bash
sysview network
```

#### memory (alias: mem)
```bash
sysview memory
sysview mem
```

#### cpu
```bash
sysview cpu
```

#### disk
```bash
sysview disk
```

#### ps (processes)
```bash
sysview ps                 # Sort by CPU
sysview ps --cpu           # Sort by CPU
sysview ps --memory        # Sort by memory
```

#### process (process tree)
```bash
sysview process            # Show help
sysview process --tree     # Show process tree
sysview process --list    # Show process list
sysview process -l -m     # List sorted by memory
```

#### top (interactive)
```bash
sysview top               # Start monitoring
sysview top --start       # Same as above
sysview top -i 1000       # 1 second refresh
sysview top -n 10         # Show 10 processes
```

#### git
```bash
sysview git               # Show status (default)
sysview git --status       # Show status
sysview git --branches     # Show branches
sysview git --log          # Show recent commits
sysview git --log 20      # Show 20 commits
sysview git --remotes      # Show remotes
sysview git --stash        # Show stash
sysview git --contributors # Show contributors
sysview git --tags         # Show tags
sysview git --diff         # Show diff
sysview git --staged       # Show staged diff
sysview git --shortlog     # Show shortlog
sysview git --all          # Show all git info
```

#### kill
```bash
sysview kill 3000          # Kill by port
sysview kill 42872         # Kill by PID
sysview kill 3000 -f       # Force kill
```

#### watch (real-time dashboard)
```bash
sysview watch              # Show help
sysview watch --start      # Start watching
sysview watch -i 1000      # 1 second refresh
```

#### dashboard
```bash
sysview dashboard          # Full overview
sysview dash              # Alias
```

## Features

- **Cross-platform**: Works on macOS and Linux
- **Color-coded**: Green (good), Yellow (warning), Red (critical)
- **Progress bars**: Visual representation of usage
- **Process tree**: Hierarchical view of processes
- **Git integration**: Status, branches, commits, remotes
- **Interactive**: Real-time monitoring mode

## Links

- **npm**: https://www.npmjs.com/package/@12britz/sysview
- **GitHub**: https://github.com/12britz/sysview

## License

MIT