cv4pve-cli
kubectl-style remote CLI for Proxmox VE with multi-cluster support and shell completion
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Corsinvest/cv4pve-cli with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Corsinvest/cv4pve-cli'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/corsinvest--cv4pve-cli)HTML
<a href="/listings/corsinvest--cv4pve-cli"><img src="/api/listings/corsinvest--cv4pve-cli/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
# Windows winget install Corsinvest.cv4pve.cli # Linux (other platforms and packages: see the documentation) wget https://github.com/Corsinvest/cv4pve-cli/releases/latest/download/cv4pve-cli-linux-x64.zip unzip cv4pve-cli-linux-x64.zip && chmod +x cv4pve-cli # Save the cluster once, with an API token, then run commands against it ./cv4pve-cli config add pve01 --host=pve01.example.com --api-token='cli@pve!cli=UUID' ./cv4pve-cli get nodes ./cv4pve-cli api get /cluster/resources --type vm -o json
The token and the password are saved in clear text in `~/.cv4pve/cli/config`: use a dedicated API token with only the privileges you want cv4pve-cli to have (see [Permissions](https://corsinvest.github.io/cv4pve-cli/permissions/)).
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 128 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # <img src="icon.png" alt="" height="36" align="top"> cv4pve-cli
- ```
- ______ _ __
- / ____/___ __________(_)___ _ _____ _____/ /_
- / / / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
- / /___/ /_/ / / (__ ) / / / / |/ / __(__ ) /_
- \____/\____/_/ /____/_/_/ /_/|___/\___/____/\__/
- Command Line Interface for Proxmox VE (Made in Italy)
- ```
- [](LICENSE.md)
- [](https://github.com/Corsinvest/cv4pve-cli/releases/latest)
- [](https://github.com/Corsinvest/cv4pve-cli/releases)
- [](https://winstall.app/apps/Corsinvest.cv4pve.cli)
- [](https://aur.archlinux.org/packages/cv4pve-cli)
- > **The whole Proxmox VE API from the command line**, what `kubectl` is to Kubernetes: saved contexts for several clusters, more than 300 built-in aliases and tab completion that reads the live cluster.
- >
- > **[Documentation](https://corsinvest.github.io/cv4pve-cli/)**
- ---
- ## Why
- The Proxmox VE web interface is made for clicking, one object at a time. The API behind it does the same work, but calling it by hand means a login, a ticket and a `curl` line for each call. [`pvesh`](https://pve.proxmox.com/pve-docs/pvesh.1.html) is simpler, but it runs only on a node, as root, and knows only the cluster that node belongs to.
- cv4pve-cli puts the whole API in a command you run from your own workstation. You save each cluster once, switch between them by name, and type `do start vm --guest web01` instead of looking up which node the guest runs on. Coming from pvesh? See [each command mapped](https://corsinvest.github.io/cv4pve-cli/coming-from-pvesh/).
- It **runs outside the nodes and uses only the Proxmox VE API**: nothing to install on the cluster, no SSH. It can do exactly what the API token of its context is allowed to do.
- ---
- ## What it looks like
- ```
- $ cv4pve-cli get vm status --guest mailstore
- +--------------+------------+
- | key | value |
- +--------------+------------+
- | agent | 1 |
- | cpus | 2 |
- | maxmem | 4294967296 |
- | mem | 2030592000 |
- | name | mailstore |
- | qmpstatus | running |
- | running-qemu | 9.2.0 |
- | status | running |
- | uptime | 7803584 |
- | vmid | 1012 |
- +--------------+------------+
- ```
- Some of the rows. `--guest` found the node and the VM ID from the name; `-o json` gives the same data to a script.
- ---
- ## Features
- - **Every API call**: `api get/set/create/delete` on any path, `api ls` and `api usage` to find what a path accepts.
- - **Several clusters**: each one a saved context; switch with `config use`.
- - **Aliases**: more than 300 built-in short commands (`get nodes`, `do migrate vm`, `create guest snapshot`…) plus your own.
- - **Guests by name**: `--guest <name|id>` fills in node, type and VM ID.
- - **Tab completion**: bash, zsh and PowerShell complete API paths, node names, VM IDs, parameters and their allowed values from the live cluster.
- - **Tasks**: `task list/show/wait/log --follow/stop` to follow backups, migrations and other long operations.
- - **Made for scripts**: output as text, JSON, Markdown or HTML; errors on stderr with an exit code for each kind of failure; `--dry-run` to see a call before sending it.
- - **Windows, Linux and macOS**, with no runtime to install.
- ---
- ## Quick start
- ```bash
- # Windows
- winget install Corsinvest.cv4pve.cli
- # Linux (other platforms and packages: see the documentation)
- wget https://github.com/Corsinvest/cv4pve-cli/releases/latest/download/cv4pve-cli-linux-x64.zip
- unzip cv4pve-cli-linux-x64.zip && chmod +x cv4pve-cli
- # Save the cluster once, with an API token, then run commands against it
- ./cv4pve-cli config add pve01 --host=pve01.example.com --api-token='cli@pve!cli=UUID'
- ./cv4pve-cli get nodes
- ./cv4pve-cli api get /cluster/resources --type vm -o json
- ```
- The token and the password are saved in clear text in `~/.cv4pve/cli/config`: use a dedicated API token with only the privileges you want cv4pve-cli to have (see [Permissions](https://corsinvest.github.io/cv4pve-cli/permissions/)).
- ---
- ## Documentation
- | | |
- |---|---|
- | [Getting started](https://corsinvest.github.io/cv4pve-cli/getting-started/) | Install, first context, first commands |
- | [Contexts](https://corsinvest.github.io/cv4pve-cli/contexts/) | Several clusters, token or password, certificate, where credentials are stored |
- | [Permissions](https://corsinvest.github.io/cv4pve-cli/permissions/) | The user, the API token and the role to give it |
- | [Coming from pvesh](https://corsinvest.github.io/cv4pve-cli/coming-from-pvesh/) | Each pvesh command and option in cv4pve-cli |
- | [API calls](https://corsinvest.github.io/cv4pve-cli/api/) | `get`, `set`, `create`, `delete`, `ls`, `usage`, output formats |
- | [Aliases](https://corsinvest.github.io/cv4pve-cli/aliases/) | Built-in aliases, `--guest`, your own aliases |
- | [Tasks](https://corsinvest.github.io/cv4pve-cli/tasks/) | Following tasks by UPID |
- | [Tab completion](https://corsinvest.github.io/cv4pve-cli/completion/) | bash, zsh, PowerShell |
- | [Scripting](https://corsinvest.github.io/cv4pve-cli/scripting/) | JSON output, exit codes, CI |
- | [AI assistants](https://corsinvest.github.io/cv4pve-cli/ai-agents/) | Claude Code, Codex, the `cv4pve-cli` skill |
- | [Reference](https://corsinvest.github.io/cv4pve-cli/reference/commands/) | Every command, every alias, every file |
- ---
- ## Related tools
- Prefer PowerShell objects to text? [cv4pve-api-powershell](https://github.com/Corsinvest/cv4pve-api-powershell) gives the same API as cmdlets. For an inventory of the cluster use [cv4pve-report](https://github.com/Corsinvest/cv4pve-report), to find what is wrong [cv4pve-diag](https://github.com/Corsinvest/cv4pve-diag). The whole suite: [corsinvest.it/cv4pve](https://www.corsinvest.it/en/cv4pve/).
- ---
- ## Support
- Professional support and consulting available through [Corsinvest](https://www.corsinvest.it/en/cv4pve/).
- ---
- **By sysadmins, for sysadmins.**
- Part of [cv4pve](https://www.corsinvest.it/en/cv4pve/) suite | Made with ❤️ in Italy by [Corsinvest](https://www.corsinvest.it)
- Proxmox® is a registered trademark of Proxmox Server Solutions GmbH. cv4pve is developed by Corsinvest and is not a Proxmox product.
- Copyright © Corsinvest Srl
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.