Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/corsinvest--cv4pve-cli/badge.svg)](/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

i

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)

  1. # <img src="icon.png" alt="" height="36" align="top"> cv4pve-cli
  2. ```
  3. ______ _ __
  4. / ____/___ __________(_)___ _ _____ _____/ /_
  5. / / / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
  6. / /___/ /_/ / / (__ ) / / / / |/ / __(__ ) /_
  7. \____/\____/_/ /____/_/_/ /_/|___/\___/____/\__/
  8. Command Line Interface for Proxmox VE (Made in Italy)
  9. ```
  10. [![License](https://img.shields.io/github/license/Corsinvest/cv4pve-cli.svg?style=flat-square)](LICENSE.md)
  11. [![Release](https://img.shields.io/github/release/Corsinvest/cv4pve-cli.svg?style=flat-square)](https://github.com/Corsinvest/cv4pve-cli/releases/latest)
  12. [![Downloads](https://img.shields.io/github/downloads/Corsinvest/cv4pve-cli/total.svg?style=flat-square&logo=download)](https://github.com/Corsinvest/cv4pve-cli/releases)
  13. [![WinGet](https://img.shields.io/winget/v/Corsinvest.cv4pve.cli?style=flat-square&logo=windows)](https://winstall.app/apps/Corsinvest.cv4pve.cli)
  14. [![AUR](https://img.shields.io/aur/version/cv4pve-cli?style=flat-square&logo=archlinux)](https://aur.archlinux.org/packages/cv4pve-cli)
  15. > **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.
  16. >
  17. > **[Documentation](https://corsinvest.github.io/cv4pve-cli/)**
  18. ---
  19. ## Why
  20. 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.
  21. 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/).
  22. 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.
  23. ---
  24. ## What it looks like
  25. ```
  26. $ cv4pve-cli get vm status --guest mailstore
  27. +--------------+------------+
  28. | key | value |
  29. +--------------+------------+
  30. | agent | 1 |
  31. | cpus | 2 |
  32. | maxmem | 4294967296 |
  33. | mem | 2030592000 |
  34. | name | mailstore |
  35. | qmpstatus | running |
  36. | running-qemu | 9.2.0 |
  37. | status | running |
  38. | uptime | 7803584 |
  39. | vmid | 1012 |
  40. +--------------+------------+
  41. ```
  42. Some of the rows. `--guest` found the node and the VM ID from the name; `-o json` gives the same data to a script.
  43. ---
  44. ## Features
  45. - **Every API call**: `api get/set/create/delete` on any path, `api ls` and `api usage` to find what a path accepts.
  46. - **Several clusters**: each one a saved context; switch with `config use`.
  47. - **Aliases**: more than 300 built-in short commands (`get nodes`, `do migrate vm`, `create guest snapshot`…) plus your own.
  48. - **Guests by name**: `--guest <name|id>` fills in node, type and VM ID.
  49. - **Tab completion**: bash, zsh and PowerShell complete API paths, node names, VM IDs, parameters and their allowed values from the live cluster.
  50. - **Tasks**: `task list/show/wait/log --follow/stop` to follow backups, migrations and other long operations.
  51. - **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.
  52. - **Windows, Linux and macOS**, with no runtime to install.
  53. ---
  54. ## Quick start
  55. ```bash
  56. # Windows
  57. winget install Corsinvest.cv4pve.cli
  58. # Linux (other platforms and packages: see the documentation)
  59. wget https://github.com/Corsinvest/cv4pve-cli/releases/latest/download/cv4pve-cli-linux-x64.zip
  60. unzip cv4pve-cli-linux-x64.zip && chmod +x cv4pve-cli
  61. # Save the cluster once, with an API token, then run commands against it
  62. ./cv4pve-cli config add pve01 --host=pve01.example.com --api-token='cli@pve!cli=UUID'
  63. ./cv4pve-cli get nodes
  64. ./cv4pve-cli api get /cluster/resources --type vm -o json
  65. ```
  66. 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/)).
  67. ---
  68. ## Documentation
  69. | | |
  70. |---|---|
  71. | [Getting started](https://corsinvest.github.io/cv4pve-cli/getting-started/) | Install, first context, first commands |
  72. | [Contexts](https://corsinvest.github.io/cv4pve-cli/contexts/) | Several clusters, token or password, certificate, where credentials are stored |
  73. | [Permissions](https://corsinvest.github.io/cv4pve-cli/permissions/) | The user, the API token and the role to give it |
  74. | [Coming from pvesh](https://corsinvest.github.io/cv4pve-cli/coming-from-pvesh/) | Each pvesh command and option in cv4pve-cli |
  75. | [API calls](https://corsinvest.github.io/cv4pve-cli/api/) | `get`, `set`, `create`, `delete`, `ls`, `usage`, output formats |
  76. | [Aliases](https://corsinvest.github.io/cv4pve-cli/aliases/) | Built-in aliases, `--guest`, your own aliases |
  77. | [Tasks](https://corsinvest.github.io/cv4pve-cli/tasks/) | Following tasks by UPID |
  78. | [Tab completion](https://corsinvest.github.io/cv4pve-cli/completion/) | bash, zsh, PowerShell |
  79. | [Scripting](https://corsinvest.github.io/cv4pve-cli/scripting/) | JSON output, exit codes, CI |
  80. | [AI assistants](https://corsinvest.github.io/cv4pve-cli/ai-agents/) | Claude Code, Codex, the `cv4pve-cli` skill |
  81. | [Reference](https://corsinvest.github.io/cv4pve-cli/reference/commands/) | Every command, every alias, every file |
  82. ---
  83. ## Related tools
  84. 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/).
  85. ---
  86. ## Support
  87. Professional support and consulting available through [Corsinvest](https://www.corsinvest.it/en/cv4pve/).
  88. ---
  89. **By sysadmins, for sysadmins.**
  90. Part of [cv4pve](https://www.corsinvest.it/en/cv4pve/) suite | Made with ❤️ in Italy by [Corsinvest](https://www.corsinvest.it)
  91. Proxmox® is a registered trademark of Proxmox Server Solutions GmbH. cv4pve is developed by Corsinvest and is not a Proxmox product.
  92. Copyright © Corsinvest Srl

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.