Stats
Actions
Available In
Tags
Plugin
proxmox-mgmt
Manage a Proxmox VE host via SSH and the Proxmox API — guided first-run onboarding, VM/CT lifecycle, storage and ZFS inspection, log review, and update workflows. Per-host config is stored outside the plugin so the same install works across multiple Proxmox environments.
What's Inside
Skills2
onboard
/onboard
First-run onboarding for the proxmox-mgmt plugin. Interview the user about their Proxmox host — IP, SSH user, web UI URL, and (optionally) Proxmox API token references — and persist the result to `$CLAUDE_USER_DATA/proxmox-mgmt/config.json`. Run this before any other skill in this plugin, or whenever the connection details change. Triggers on phrases like "set up proxmox", "onboard proxmox", "configure proxmox plugin".
proxmox-maintenance
/proxmox-maintenance
Use when the user wants to perform maintenance, diagnostics, or configuration on their Proxmox VE host via SSH or the Proxmox API. Reads connection details from `$CLAUDE_USER_DATA/proxmox-mgmt/config.json` (populated by the `onboard` skill in this plugin). Triggers on phrases like "proxmox maintenance", "check proxmox", "connect to proxmox", "list VMs", "list containers", "proxmox host".
README
Proxmox Management Plugin
A Claude Code plugin for managing a Proxmox VE host. SSH-based diagnostics and lifecycle ops with optional Proxmox API support.
Per-host details (IP, SSH user, API token references) are stored outside the plugin at $CLAUDE_USER_DATA/proxmox-mgmt/config.json, so the same install works against any number of Proxmox hosts and survives plugin updates.
Skills
onboard— interactive first-run setup. Captures host, SSH user, web URL, node name, and (optionally) Proxmox API token references. Writesconfig.json.proxmox-maintenance— VM/CT lifecycle (qm,pct), storage and ZFS inspection, log review, update workflows, and Proxmox API access. Reads fromconfig.json.
Installation
claude plugins install proxmox-mgmt@danielrosehill
Quick start
- Install the plugin.
- Run the
onboardskill — Claude will interview you for the connection details and write them to$CLAUDE_USER_DATA/proxmox-mgmt/config.json. - Ask Claude things like "check proxmox", "list VMs", or "what's the ZFS pool status" — it'll read the config and connect.
Storage convention
This plugin follows the claude-rudder:plugin-data-storage convention:
- Plugin code lives at the install path (read-only, replaced on update).
- User config lives at
${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/proxmox-mgmt/config.json. - Secrets (API token secret) are never stored in the config — only a reference to where they live (1Password item, env var, file path). Skills resolve the reference at runtime.
License
MIT
Stats
Version1.0.0
Stars5
MaintenanceGood
LicenseMIT
Last Commit
Added
Available In
Tags
Categories
