pman

A terminal-based process manager with a beautiful TUI for viewing and managing listening network processes.

Preview

Features

TUI Features

• View all processes listening on network ports
• Display PORT, PID, Process Name, Protocol, Memory, Username, and Started At
• Human-readable memory format (KB, MB, GB)
• Auto-refresh every 2 seconds
• Manual refresh with r
• Vim-style navigation (j/k or arrow keys)
• Customizable color theme via ~/.config/pman/config.yaml
• Kill processes directly from the TUI

CLI Commands

• pman - Launch interactive TUI (default)
• pman json - Output process list as JSON
• pman kill <pid> - Kill process by PID
• pman killport <port> - Kill process listening on a specific port
• pman version - Show version information

Installation

Using Homebrew (Recommended on macOS)

brew tap bishalr0y/homebrew-bishalr0y
brew install pman

Using go install

go install github.com/bishalr0y/pman@latest

From Source

git clone https://github.com/bishalr0y/pman.git
cd pman
go install ./cmd/...

Usage

TUI Mode

pman

Keybindings

Key	Action
↑ / k	Move up
↓ / j	Move down
Enter	Kill selected process
r	Refresh process list
q / Esc / Ctrl+C	Quit

CLI Examples

# Output processes as JSON
pman json

# Kill a process by PID
pman kill 1234

# Kill process on a specific port
pman killport 8080

Configuration

pman reads config from ~/.config/pman/config.yaml. On first run, it auto-creates the file with defaults:

colors:
  banner: "#8bd5ca"
  version: "#7287fd"
  help_key: "#a6e3a1"
  help_desc: "#babbf1"
  help_separator: "#8bd5ca"
  header_fg: "#7287fd"
  selected_bg: "#7287fd"
  selected_fg: "#f9e2af"
  border_fg: "#6c7086"

Each key controls a specific UI element — change any hex value to customize the theme.

Requirements

• Go 1.25 or later
• macOS or Linux

License

MIT