# proxmox-manager

A single Bash script that wraps Proxmox CLI tools (`qm`, `pct`) into an interactive TUI menu. No daemons, no agents, no dependencies beyond what ships with Proxmox VE. Runs on the host, manages the local node only.

**What it does:**
- Lists all VMs and containers with status indicators (`[+]` running, `[-]` stopped, `[~]` paused)
- Start, stop, restart with confirmation prompts for destructive actions
- Open console (LXC shell or QEMU terminal)
- Snapshot management: list, create, rollback, delete
- SPICE connection details for VMs
- Machine-readable JSON and plain-text output modes for scripting

**Usage:**

```sh
pman              # interactive TUI
pman --list       # plain-text table
pman --json       # JSON output for automation
```

In interactive mode, enter a VMID to get an action menu. `r` to refresh, `q` to quit.

**Install:** clone the repo onto a Proxmox host, `chmod +x`, optionally run `install_dependencies.sh` to get a `pman` symlink in `/usr/local/bin/`. No Python, no Docker, no external APIs. Requires root (or `PROXMOX_MANAGER_ALLOW_NONROOT=1` for CI).

Tested on Proxmox VE 7.x, 8.x, and 9.x.

[[perfmon]] is the same shape pointed at diagnostics instead of lifecycle: a TUI whose tabs are just shell commands (`top`, `vmstat`, `ss`) on a refresh interval, so it never has to learn anything the CLI already knows. Both stay useful because the underlying commands, not the wrapper, hold the knowledge.

**Repo:** https://github.com/TimInTech/proxmox-manager — 22 stars, MIT license.