Agent skill · operations · aaaaqwq
proxmox-ops
Create a credential file at `~/.proxmox-credentials`
Why this skill is useful
Includes a helper script (pve.sh) that automates Proxmox operations and provides operational safety features not available in public documentation.
What it needs
Requires curl, jq installed locally. About 4k tokens when loaded. Last updated 2026-08-06. 83 stars on the source repository.
What this skill does
Proxmox VE Management First-Time Setup Create a credential file at ~/.proxmox-credentials: Alternative: Set PROXMOXHOST, PROXMOXTOKENID, and PROXMOXTOKENSECRET as environment variables directly (useful for CI/agent contexts). The helper script checks env vars first, then falls back to sourcing ~/.proxmox-credentials. Create API token in Proxmox: Datacenter → Permissions → API Tokens → Add. Use least-privilege: only grant the permissions your workflow requires (e.g., PVEAuditor for read-only monitoring, PVEVMAdmin for VM control). Disable Privilege Separation only if your workflow requires full API access. Auth Header Helper Script scripts/pve.sh auto-discovers nodes from VMID — no need to specify the node for most operations. Workflow 1. Load credentials from ~/.proxmox-credentials 2. Determine operation type: Read-only (status, list, storage, tasks) → Execute directly Reversible (start, stop, reboot, snapshot) → Execute, note UPID for tracking Destructive (delete VM, resize disk, rollback snapshot) → Confirm with user first 3. Query Proxmox API via curl + API token auth 4. Parse JSON with jq 5. Track async tasks — create/clone/backup operations return UPID Common Operations Cluster & Nodes List VMs & Containers VM/Container Control Snapshots ⚠️ vmstate parameter: Do NOT include vmstate=1 unless you specifically need to preserve running process state. vmstate=1 freezes the VM and causes heavy I/O — can starve other guests on the same node For pre-change backups, omit vmstate (defaults to disk-only, no I/O spike) Disk Resize Post-resize inside VM: 1. Fix GPT: parted /dev/sda print → Fix 2. Resize partition: parted /dev/sda resizepart 3 100% 3. If LVM: pvresize /dev/sda3 && lvextend -l +100%FREE /dev/vg/root 4. Resize filesystem: resize2fs /dev/mapper/vg-root (ext4) or xfsgrowfs / (xfs) Guest Agent (IP Discovery) Always query guest agent for current IP — don't hardcode IPs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aaaaqwq/proxmox-ops-skill