pvetui-cli

A command-line tool for querying and managing Proxmox VE, a platform for running virtual machines and lightweight containers.

In plain words
What is it for?
Use it to inspect nodes, virtual machines, containers, storage, and tasks, or to create, migrate, start, stop, restore, and manage guests when the required access is configured.
Why use it?
It lets scripts or coding agents inspect and operate Proxmox resources without needing to work through an interactive terminal interface.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/devnullvoid/pvetui/pvetui-cli
Any agent
npx skills add devnullvoid/pvetui --skill pvetui-cli
Clone the repo
git clone --depth 1 https://github.com/devnullvoid/pvetui

Made for: Claude Code, Codex.

Per session 77 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,884 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00077 $0.07884
Opus 5 $0.00039 $0.03942
Sonnet 5 $0.00015 $0.01577
Haiku 4.5 $0.00008 $0.00788

Measured 2d ago against content hash 9e48f496427f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

pvetui-cli scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

For agent-driven deployments, prefer `plan` first, then `deploy --yes` with explicit `--set var_*=value` overrides. For unattended LXC deploys, include `var_container_storage` and `var_template_storage`; otherwise upstre
skills/pvetui-cli/SKILL.md · 769 lines

How it starts

The opening of the file, as written. The whole thing — 769 lines — stays where its author put it; the contents beside it link to each section on GitHub.

pvetui CLI

pvetui is a terminal UI and CLI for Proxmox VE. When invoked with a subcommand it runs non-interactively, making it suitable for scripts and AI agent workflows.

Installation

# Via Go (recommended)
go install github.com/devnullvoid/pvetui/cmd/pvetui@latest

# Via skill (Claude Code / any skills.sh-compatible agent)
npx skills add devnullvoid/pvetui

When to Use

  • Querying node status, resource usage, or uptime
  • Listing, filtering, or inspecting VMs and LXC containers
  • Starting, stopping, shutting down, or restarting guests
  • Creating VMs and LXC containers
  • Migrating guests between nodes
  • Executing commands inside a running guest without needing SSH to it
  • Opening interactive shells on nodes or inside guests
  • Listing and managing storage content (ISOs, templates, backups, disk images)
  • Downloading ISOs, appliance templates, or OCI images into storage
  • Restoring guests from vzdump backups
  • Searching, inspecting, and installing Proxmox Community Scripts when community-scripts is enabled
  • Listing recent cluster task history
  • Scripting or automating Proxmox operations without root access to a node

Prerequisites

  • pvetui installed and on $PATH
  • Config at ~/.config/pvetui/config.yml with at least one profile
  • API token or password auth configured in the profile
  • For guests exec / guests shell on LXC containers: ssh_user configured in the profile
  • For guests shell on QEMU VMs: ssh_user (and optionally vm_ssh_user) configured
  • For community-scripts install: plugins.enabled includes community-scripts, and node SSH settings are configured

Quick Reference

Command Purpose
pvetui nodes list List all cluster nodes
pvetui nodes show <node> Show details for one node
pvetui nodes shell <node> Open an interactive SSH shell on a node
pvetui guests list List all VMs and containers
pvetui guests show <vmid> Show details for one guest
pvetui guests start <vmid> Start a guest
pvetui guests stop <vmid> Force stop a guest (power off)
pvetui guests shutdown <vmid> Graceful ACPI shutdown
pvetui guests restart <vmid> Graceful restart
pvetui guests delete <vmid> Permanently delete a guest and its disks
pvetui guests exec <vmid> <cmd> Run a command inside a guest
pvetui guests shell <vmid> Open an interactive shell inside a guest
pvetui guests create vm Create a QEMU VM
pvetui guests create lxc Create an LXC container
pvetui guests migrate <vmid> <node> Migrate a guest to another node
pvetui tasks list List recent cluster tasks
pvetui storage list List storages across the cluster
pvetui storage show <node> <storage> Show details for a storage
pvetui storage content list <node> <storage> List content in a storage
pvetui storage content delete <node> <storage> <volid> Delete a content item
pvetui storage download url <node> <storage> <url> Download from a URL
pvetui storage download template <node> <storage> <template> Download an appliance template
pvetui storage download oci <node> <storage> <reference> Pull an OCI image
pvetui storage restore <node> <storage> <volid> <vmid> Restore a guest from backup
pvetui community-scripts search <query> Search available Proxmox Community Scripts
pvetui community-scripts show <slug-or-name> Show Community Script metadata
pvetui community-scripts plan <slug-or-name> --node <node> Preview a Community Script node install command
pvetui community-scripts plan <slug-or-name> --guest <vmid> Preview a tools/addon install inside an existing LXC
pvetui community-scripts install <slug-or-name> --node <node> Install a Community Script on a node over SSH
pvetui community-scripts install <slug-or-name> --guest <vmid> Install a tools/addon script inside an existing LXC
pvetui community-scripts deploy <slug-or-name> --node <node> Alias for install, useful for agent deployment wording

Read the full file on GitHub · 769 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 769 lines · 77 tokens per session scan B 9e48f496427f

Subscribe to this mod's changes

pvetui-cli is a skill published in the GitHub repository devnullvoid/pvetui (716 stars, last pushed 5d ago), licensed MIT. It adds 77 tokens to every session and 7,884 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.