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

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.

It lets scripts or coding agents inspect and operate Proxmox resources without needing to work through an interactive terminal interface.

pvetui-cli — Skill for Claude Code and Codex by devnullvoid/pvetui

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.

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.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/devnullvoid/pvetui/pvetui-cli/github.svg)](https://agentmods.dev/skills/devnullvoid/pvetui/pvetui-cli)

Your own site

<a href="https://agentmods.dev/skills/devnullvoid/pvetui/pvetui-cli"><img src="https://agentmods.dev/badge/skills/devnullvoid/pvetui/pvetui-cli/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/devnullvoid/pvetui/pvetui-cli"><img src="https://agentmods.dev/badge/skills/devnullvoid/pvetui/pvetui-cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 77 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 8,624 The whole file, excluding the scripts and references it only reads on demand.

Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector warn 7 Sept 2026

SkillSpector: 5 findings, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

medium MCP Rug Pull · line 21
npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.

Fix: Pin the version: npx @scope/[email protected]
medium Privilege Escalation · line 158
Commands invoke sudo or root privileges. Verify this elevated access is necessary and justified.

Fix: Avoid sudo/root unless strictly required. Prefer least-privilege patterns. If elevation is needed, document the justification and scope.
medium Privilege Escalation · line 160
Commands invoke sudo or root privileges. Verify this elevated access is necessary and justified.

Fix: Avoid sudo/root unless strictly required. Prefer least-privilege patterns. If elevation is needed, document the justification and scope.
medium Privilege Escalation · line 766
Commands invoke sudo or root privileges. Verify this elevated access is necessary and justified.

Fix: Avoid sudo/root unless strictly required. Prefer least-privilege patterns. If elevation is needed, document the justification and scope.
medium Privilege Escalation · line 767
Commands invoke sudo or root privileges. Verify this elevated access is necessary and justified.

Fix: Avoid sudo/root unless strictly required. Prefer least-privilege patterns. If elevation is needed, document the justification and scope.

How audits are shown

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.

Model	Per session	Once invoked
Fable 5.1	$0.00077	$0.08624
Opus 5.5	$0.00031	$0.03450
Sonnet 5.5	$0.00015	$0.01725
Haiku 4.5	$0.00008	$0.00862

Measured 13d ago against content hash 84256f85c8cd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 13d 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 · 834 lines

How it starts

The opening of the file, as written. The whole thing — 834 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

TUI-only preferences (confirm_quit, startup_page, quiet_startup, and auto_refresh.enabled / auto_refresh.interval) do not change CLI query output or task polling. Use cli.default_output for CLI output defaults. Launch the TUI with pvetui --startup-page guests to override its configured initial view.

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 resize <vmid> <disk> <size>`	Resize a guest disk or LXC rootfs
`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 · 834 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.

13d ago Changed · +65 lines 84256f85c8cd
1mo 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 (745 stars, last pushed 2d ago), licensed MIT. It adds 77 tokens to every session and 8,624 once invoked, about $0.0003 per session on Opus 5.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.

Containers DevOps and cloud go proxmox proxmox-ve pve terminal-ui tui

ecspresso

ECS deployment tool - deploy, manage, and troubleshoot ECS services.

kayac/ecspresso · 17 tokens

write-zot-themes

Help the user create, install, or package zot themes, including theme-only extensions.

patriceckhart/zot · 23 tokens

lingtai-tui-anatomy

Source-navigation guide for the LingTai Go monorepo that ships lingtai-tui and lingtai-portal. Read this for TUI/Portal structure, runtime-boundary evidence, exact Go ownership, or when updating an ANATOMY.md. The repository-root ANATOMY.md is normative; this skill routes into that graph without duplicating it. Kernel…

Lingtai-AI/lingtai · 100 tokens

pvetui-cli