keeb/swamp-proxmox
1
0
Fork 0
Code Projects Releases Packages Wiki Activity
No description
5 commits 1 branch 0 tags 47 KiB
  • TypeScript 100%
Find a file
Exact
keeb 2df02fe938 feat: add embedded proxmox skill for AI agents 
Bundle a SKILL.md describing the @user/proxmox/node and @user/proxmox/vm
models so AI agents loading the @keeb/proxmox extension automatically gain
context on the auth flow, fleet lifecycle methods, CEL wiring patterns, and
PXE/guest-agent gotchas. Bumps version to 2026.04.06.1 and registers the
skill in manifest.yaml so swamp packages it into the extension archive.
2026-04-06 18:35:58 -07:00
.claude/skills/proxmox feat: add embedded proxmox skill for AI agents 2026-04-06 18:35:58 -07:00
.swamp/workflows Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:46 -08:00
extensions/models Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:46 -08:00
workflows Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:46 -08:00
.gitignore Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:46 -08:00
.swamp.yaml Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:46 -08:00
CLAUDE.md Add repository and tags to manifest 2026-03-02 22:01:55 -08:00
manifest.yaml feat: add embedded proxmox skill for AI agents 2026-04-06 18:35:58 -07:00
README.md Initial commit: @keeb/$NAME swamp extension 2026-02-27 12:30:46 -08:00

README.md

@keeb/proxmox

Swamp extension for Proxmox VE API authentication and VM fleet lifecycle management.

Models

proxmox/node

Authenticate with a Proxmox VE node and cache auth tickets.

Method Description
auth Authenticate and write ticket + CSRF token as a named resource

proxmox/vm

Fleet-style VM lifecycle management. Every method writes a named resource per VM, enabling CEL-based wiring to downstream models.

Method Description
lookup Look up a VM by name and write its current state
create Create a new VM (PXE boot, default specs)
start Start a VM and wait for IP via guest agent
stop Stop a VM
delete Delete a VM (stops first if running)
setBootOrder Set VM boot order
setConfig Set arbitrary VM config options
sync Sync all VMs from the Proxmox node into fleet named resources

Workflows

Workflow Description
sync-fleet Authenticate + sync all VMs into fleet
start-vm Start any VM by name
stop-vm Stop any VM by name
create-vm Create a new VM by name
delete-vm Delete a VM by name
vm-lifecycle-test Full create/start/stop/delete test cycle
guest-agent-test Create, start, validate IP via guest agent, cleanup

Dependencies

Used by

Install

swamp extension pull @keeb/proxmox

License

MIT