Skip to content

Release v2.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 14 Jul 05:54
0eace14

Commands

  • Added a task command tree to inspect and follow async Proxmox tasks by UPID: task list, task show, task wait, task log (with --follow to tail live, polling every 2s) and task stop.
  • Every alias now honors --wait to block until the async Proxmox task finishes (previously the flag was ignored on aliases — start/backup/migrate were fire-and-forget).

Aliases

  • Added do restore vm and do restore ct to restore a guest from a vzdump backup archive.
  • Added Ceph read aliases: get ceph status/flags and get node ceph status/osds/mons/mgrs/pools/fs/config.

Scripting

  • Commands now return semantic exit codes (0 ok, 1 generic, 2 auth/config, 3 not-found, 4 api/server, 5 task-failed, 6 validation) and print errors to stderr instead of stdout — previously failures printed to stdout and still returned 0.

Bug fixes

  • Fixed a startup crash (ArgumentNullException) that made every command fail — the --log-level option was not registered.

Documentation

  • Added docs/commands.md (core command reference) and docs/aliases.md (full alias list, regenerable via alias list --output markdown), linked from the README.
  • Added tips for running cv4pve-cli inside AI coding assistants (docs/AI-AGENTS.md).

What's Changed

  • docs: add guide for using cv4pve-cli with AI coding assistants (#10) by @franklupo in #11
  • Add restore/ceph aliases, docs pages, fix startup crash by @franklupo in #12
  • Add semantic exit codes and send errors to stderr by @franklupo in #13
  • Wire --wait on aliases (was hardcoded false) by @franklupo in #14
  • Add task subcommand (list/show/wait/log --follow/stop) by @franklupo in #15
  • Release 2.3.0 by @franklupo in #16

Full Changelog: v2.2.1...v2.3.0