Perfmon
- title
- Perfmon
- type
- toolbox
- summary
- Tabbed Bubble Tea TUI that runs top, vmstat and ss side by side with live sparklines
- tags
- golang, tui, monitoring, cli
- language
- Go
- license
- MIT
- created
- 2026-04-06
- updated
- 2026-04-06
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:
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):
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.