incus-contrib/.claude/skills/proxmox-api.md

35 lines
894 B
Markdown

---
name: proxmox-api
description: Make an authenticated Proxmox API call
user_invocable: true
arguments:
- name: args
description: "METHOD PATH [--json]"
required: true
---
# Proxmox API Skill
Make an authenticated Proxmox API call with proper token handling.
## Steps
1. Run the helper script:
```bash
/home/maarten/dev/incus-contrib/incusos/helpers/proxmox-api {{args}}
```
2. Parse the JSON response
3. Present the results in a readable format
## Notes
- The helper handles the `!` in `automation@pve!deploy` safely
- Reads host and token ID from `proxmox.yaml`, secret from env file
- Add `--json` for pretty-printed output
- Common paths:
- `/nodes/pve/qemu` -- list all VMs
- `/nodes/pve/qemu/{vmid}/status/current` -- VM status
- `/nodes/pve/status` -- host resources
- `/cluster/resources` -- cluster-wide resources
- `/pools/{pool}` -- pool members