pm-tui

Terminal UI for Proxmox VE. Browse nodes, VMs, and LXCs. Start, stop, shutdown, reboot guests.

Build & Run

make build   # produces ./pm-tui
make run     # builds + runs

Config

TOML at ~/.config/proxmox-tui/config.toml:

[proxmox]
url           = "https://proxmox.example.com:8006"
token_id      = "user@pam!token"
token_secret  = "uuid-secret"
tls_insecure  = true
poll_interval = 5    # seconds
timeout       = 30   # seconds

First-run: press h to show node panel, then Enter on + Add Node to configure interactively.

Layout

Three-panel TUI:

Panel	Content
NODES (togglable)	Proxmox nodes, status indicator
GUESTS	VMs + LXCs on selected node, sorted by ID, status dot
DETAIL	Guest/node info, status, CPU, RAM

Status bar at bottom: spinner + hints + messages.

Navigation

Key	Action
h	Toggle node panel
Tab / Shift+Tab	Cycle focus forward/backward
j/k or ↑/↓	Move selection
Enter / l	Select node / focus detail
u	Start guest
d	Shutdown guest
U	Reboot guest
D	Force-stop guest
r	Refresh data
m	Toggle message log
q / Ctrl+C	Quit