Proxmox Management

Manage Proxmox VE nodes, VMs, and containers. Can list hardware stats, resources, control power states (start, stop, reboot, shutdown), and manage snapshots (create, list, rollback, delete).

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