# Perfmon

A terminal performance monitor that consolidates output from multiple diagnostic tools (`top`, `vmstat`, `ss`, `netstat`, etc.) into a single tabbed TUI. Built with Bubble Tea.

The main value over running those tools separately: a tabbed interface so you can switch between metrics without terminal clutter, plus live sparklines for load, CPU, memory, and network as an at-a-glance health bar.

**Usage:**

```sh
perfmon          # start with default system tools
```

Navigate with `Tab`/`Shift+Tab` between tabs, `j`/`k` to scroll output, `t` to toggle light/dark theme, `q` to quit.

**Configuration** via `perfmon.toml` (searched in `$PERFMON_CONFIG`, `~/.config/perfmon/config.toml`, or current directory):

```toml
global_refresh_interval = "5s"

[[tab]]
title = "Process Explorer"
cmd = ["top", "-b", "-n", "1"]
refresh_interval = "2s"

[[tab]]
title = "Network Connections"
cmd = ["ss", "-tulpn"]
```

Each tab runs an arbitrary shell command and displays its output. You can add whatever diagnostic commands you want — it's just a configurable command runner with a nice display layer. Per-tab refresh intervals let you poll fast-changing metrics more frequently.

**Cross-platform:** ships with sensible defaults for both Linux and macOS (different commands for `top`, network stats, etc.).

**Install:** `go install github.com/sumant1122/Perfmon@latest` or grab a binary from releases.

**Repo:** https://github.com/sumant1122/Perfmon — 84 stars, MIT license.