Overview

Last updated: April 11, 2026

Proxmox Module Overview (proxm0x)

The proxm0x package provides integration with Proxmox VE (Virtual Environment) for managing virtual machines and containers.

Key Features

  • Cluster Management: Fetches status and resource usage from a Proxmox cluster.
  • VM/CT Lifecycle: Supports starting, stopping, and restarting virtual machines and LXC containers.
  • ZFS Monitoring: Queries ZFS pool health and capacity directly from the Proxmox nodes.

Key Files

  • proxm0x/proxm0x.go: The API client for the Proxmox VE REST API.

Integration Flow

The telemetry_poller (in assistant/telemetry_poller.go) calls proxm0x every 5 minutes to maintain the current state of the dLAN infrastructure. This data is then broadcast to the Mission Control "Servers" tab and injected into the sasha agent's context.

Guidance for AI Agents

  • Resource Management: When an agent detects a server alert (via NOC), it can use proxm0x tools to check if a specific VM is down and attempt a restart if authorized.
  • Telemetry Reliance: Trust the Proxmox telemetry injected into your context; it is updated frequently and represents the source of truth for the virtual infrastructure.

Cross-References