cv4pve-cli 2.4.0

What's new in 2.4.0

What's new
- Documentation site at https://corsinvest.github.io/cv4pve-cli/: contexts, permissions, API calls, aliases, tasks, tab completion, scripting, AI coding assistants, coming from pvesh, and a reference of every command, alias and file.
- Output as pvesh shows it. Lists show the columns the API schema describes and name the others on standard error; --all-columns (-A) shows them all. Sizes, percentages, durations and dates are printed as text (251.51 GiB, 4.44%, 3d 2h 5m 1s, 2026-09-30 14:22:23) and aligned right; --human-readable false (or 0) prints the values as the API returns them. -o json always has every column and the raw values.
- --wait-timeout <seconds> limits how long --wait waits for a task.
- Skill for AI coding assistants: skills/cv4pve-cli/SKILL.md for Claude Code, Codex and other assistants: when to use cv4pve-cli, how to read with JSON, find guests, explore the API, run changes with --dry-run first and --yes only after the user agrees.
- New aliases: performance history, node versions and services, VM migration check, firewall logs, IPSets and aliases, Corosync and QDevice, SDN apply, guest filesystem freeze. Listed under Aliases below.
Fixes
- No key of the answer is lost: api get …/config, show vm and -o json now list numbered keys such as net0, scsi0, ide2, usb0.
- Sizes, percentages, durations and dates are readable again: the cached API schema had lost how to render them. The cache in ~/.cv4pve/cli/cache is rebuilt once.
- Tab completion after --guest proposes the parameters and their values at once: the value of --guest (or of -o, or of a --key) was read as the node, and the completion waited 30 seconds for the answer of a node that does not exist.
- Logs go to standard error: with --debug or --log-level, and for a call that fails before an answer, the log no longer mixes with the output (-o json, completions).
- Tables are aligned and escaped: numbers aligned right in text, Markdown and Html output; | in Markdown and <, & in Html no longer break the table; a value on more lines stays inside its cell.
- --wait waits until the task ends, prints its exit status and exits with 5 when it fails. It used to stop after 30 seconds and ignore the result.
- --yes is enforced. Aliases that change the cluster the most (delete, stop, reboot, rollback, restore…) ran without --yes, and failed with it because --yes was sent to Proxmox VE as a parameter. They now stop with exit code 6 without --yes, and --yes is no longer sent. …

Full release notes »