Skip to main content
← back to extensions

@keeb/proxmox

v2026.04.22.3

Proxmox API auth + VM fleet lifecycle management (https://github.com/keeb/swamp-proxmox)

Repository

https://github.com/keeb/swamp-proxmox

Platforms

linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64

Labels

proxmoxvirtualizationinfrastructure

Quality score

How well-documented and verifiable this extension is.

91%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types0/1missing
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @keeb/proxmox

Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

@keeb/sync-fleetf500c507-6d23-4d89-9d2a-c1d01d250a34

Authenticate with Proxmox and sync all VMs into the fleet

syncAuthenticate and sync all VMs from Proxmox into fleet
1.authkeebDev02.auth— Authenticate with Proxmox via keebDev02
2.sync-fleetfleet.sync— List all QEMU VMs and write per-VM named resources
@keeb/start-vm8a929a75-f1b5-4791-ba95-7ddebf97ac2e

Start a VM by name (idempotent, waits for IP)

start
1.authkeebDev02.auth
2.start-vmfleet.start
@keeb/stop-vme66c42ab-863a-42de-ae12-eb76753b0fcb

Stop a VM by name

stop
1.authkeebDev02.auth
2.stop-vmfleet.stop
@keeb/create-vmdfb23a92-2494-4b21-a9e1-ab75bed4ff46

Create a new VM by name (PXE boot, default specs)

create
1.authkeebDev02.auth
2.create-vmfleet.create
@keeb/delete-vm68178fcb-e2e3-4b05-b2ec-2f61a4e34997

Delete a VM by name (stops if running, then deletes)

delete
1.authkeebDev02.auth
2.delete-vmfleet.delete
@keeb/vm-lifecycle-test361565ac-f973-4b5a-b915-dbdfc9fb70fd

Test VM lifecycle - create, start, stop, delete using fleet with inputs

lifecycleComplete VM lifecycle test
1.authkeebDev02.auth— Authenticate with Proxmox
2.create-vmfleet.create— Create a test VM with PXE boot
3.start-vmfleet.start— Start the created VM
4.stop-vmfleet.stop— Stop the running VM
5.delete-vmfleet.delete— Delete the test VM
@keeb/guest-agent-test371d7d5e-8e75-462e-a410-2475f368f3bc

Test guest agent - create VM, start (validates agent via IP fetch), cleanup

guest-agentCreate VM, start (validates guest agent by fetching IP), cleanup
1.authkeebDev02.auth— Authenticate with Proxmox
2.create-vmfleet.create— Create a test VM with agent:1 and PXE boot (no disk)
3.start-vmfleet.start— Start the VM and wait for guest agent IP
4.stop-vmfleet.stop— Stop the test VM
5.delete-vmfleet.delete— Delete the test VM

proxmox1 file