Proxmox Skill

This skill allows the agent to interact with a Proxmox VE cluster to manage virtual machines and containers.

Tools

proxmox_list

List Proxmox nodes or all available VMs and containers across the entire cluster.

• Command: python3 {{skillDir}}/scripts/proxmox.py {{type}}
• Args:
• type: "nodes" or "vms"

proxmox_node_health

Get hardware-level health stats (CPU usage, RAM, Uptime, Version) for a specific physical node.

• Command: python3 {{skillDir}}/scripts/proxmox.py node_health {{node}}
• Args:
• node: The name of the Proxmox host (e.g., "pve" or "hydra")

proxmox_status

Get the real-time status of a specific VM or container.

• Command: python3 {{skillDir}}/scripts/proxmox.py status {{node}} {{kind}} {{vmid}}
• Args:
• node: The Proxmox node name where the resource lives
• kind: "qemu" for VMs, "lxc" for containers
• vmid: The numerical ID of the resource (e.g., "100")

proxmox_power_action

Perform power management actions. These actions require human approval by default.

• Approval: true
• Command: python3 {{skillDir}}/scripts/proxmox.py {{action}} {{node}} {{kind}} {{vmid}}
• Args:
• action: "start", "stop", "reboot", or "shutdown"
• node: The Proxmox node name
• kind: "qemu" or "lxc"
• vmid: The ID of the resource

proxmox_list_snapshots

List all snapshots for a specific VM or container.

• Command: python3 {{skillDir}}/scripts/proxmox.py list_snapshots {{node}} {{kind}} {{vmid}}
• Args:
• node: The Proxmox node name
• kind: "qemu" or "lxc"
• vmid: The ID of the resource

proxmox_take_snapshot

Create a new snapshot of a VM or container.

• Approval: true
• Command: python3 {{skillDir}}/scripts/proxmox.py take_snapshot {{node}} {{kind}} {{vmid}} {{snapname}} {{description}}
• Args:
• node: The Proxmox node name
• kind: "qemu" or "lxc"
• vmid: The ID of the resource
• snapname: Snapshot name (alphanumeric, dashes, underscores; no spaces)
• description: Optional description of the snapshot

proxmox_rollback_snapshot

Roll a VM or container back to a previously taken snapshot. Destructive — discards changes since the snapshot.

• Approval: true
• Command: python3 {{skillDir}}/scripts/proxmox.py rollback_snapshot {{node}} {{kind}} {{vmid}} {{snapname}}
• Args:
• node: The Proxmox node name
• kind: "qemu" or "lxc"
• vmid: The ID of the resource
• snapname: Name of the snapshot to roll back to

proxmox_delete_snapshot

Delete a snapshot. Destructive — the snapshot cannot be recovered.

• Approval: true
• Command: python3 {{skillDir}}/scripts/proxmox.py delete_snapshot {{node}} {{kind}} {{vmid}} {{snapname}}
• Args:
• node: The Proxmox node name
• kind: "qemu" or "lxc"
• vmid: The ID of the resource
• snapname: Name of the snapshot to delete