proxcli 0.8.1__tar.gz → 0.8.2__tar.gz

{proxcli-0.8.1 → proxcli-0.8.2}/.github/workflows/ci.yml

@@ -70,4 +70,4 @@ jobs:
           name: dist
           path: dist/
 
-      - run: uv publish --token "${{ secrets.PYPI_TOKEN }}"
+      - run: uv publish --token "${{ secrets.PYPI_TOKEN }}" --check-url https://pypi.org/simple

{proxcli-0.8.1 → proxcli-0.8.2}/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.2] - 2026-06-20
+
+### Added
+- **vm agent interfaces** — query QEMU guest agent for network interface
+  and IP information via ``proxmox vm agent interfaces <vmid>``.
+  Requires ``qemu-guest-agent`` in the VM.
+
+### Fixed
+- CI publish job now uses ``uv publish --check-url https://pypi.org/simple``
+  to skip already-published versions instead of failing with "File already
+  exists".
+
 ## [0.8.1] - 2026-06-20
 
 ### Added
@@ -124,6 +136,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CSRF ticket auto-refresh on 401.
 - AI-agent-friendly: default JSON output, strict exit codes, `--dry-run` mode.
 
+[0.8.2]: https://github.com/xezpeleta/proxcli/releases/tag/v0.8.2
 [0.8.1]: https://github.com/xezpeleta/proxcli/releases/tag/v0.8.1
 [0.8.0]: https://github.com/xezpeleta/proxcli/releases/tag/v0.8.0
 [0.7.2]: https://github.com/xezpeleta/proxcli/releases/tag/v0.7.2

{proxcli-0.8.1 → proxcli-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxcli
-Version: 0.8.1
+Version: 0.8.2
 Summary: A CLI tool to interact with Proxmox VE nodes and clusters via the REST API
 Author-email: Xabi Ezpeleta <xezpeleta@gmail.com>
 License: MIT
@@ -177,7 +177,9 @@ proxmox completion fish > ~/.config/fish/completions/proxmox.fish
 ```bash
 proxmox vm list [--node <node>]
 proxmox vm show <vmid> [--node <node>]
-proxmox vm create --node <node> --vmid <id> --memory <mb> [--cores <n>] [--name <name>] [--storage <name>] [--net <config>]
+proxmox vm create --node <node> --memory <mb> [--vmid <id>] [--cores <n>] \
+    [--name <name>] [--cdrom <iso>] [--net <config>] [--disk <size>] \
+    [--scsihw <type>] [--bios seabios|ovmf] [--machine <type>] [--boot <order>]
 proxmox vm start <vmid> [--node <node>]
 proxmox vm stop <vmid> [--node <node>]
 proxmox vm reboot <vmid> [--node <node>]
@@ -185,6 +187,16 @@ proxmox vm suspend <vmid> [--node <node>]
 proxmox vm resume <vmid> [--node <node>]
 proxmox vm delete <vmid> [--node <node>] [--force] [--purge]
 
+# VM snapshots
+proxmox vm snapshot list <vmid> [--node <node>]
+proxmox vm snapshot create <vmid> <snapname> [--description <text>] [--vmstate 1]
+proxmox vm snapshot show <vmid> <snapname> [--node <node>]
+proxmox vm snapshot rollback <vmid> <snapname> [--start 1]
+proxmox vm snapshot delete <vmid> <snapname> [--force 1]
+
+# VM guest agent
+proxmox vm agent interfaces <vmid> [--node <node>]
+
 # VM firewall
 proxmox vm firewall options <vmid> [--node <node>]
 proxmox vm firewall enable <vmid> [--node <node>]

{proxcli-0.8.1 → proxcli-0.8.2}/README.md

@@ -154,7 +154,9 @@ proxmox completion fish > ~/.config/fish/completions/proxmox.fish
 ```bash
 proxmox vm list [--node <node>]
 proxmox vm show <vmid> [--node <node>]
-proxmox vm create --node <node> --vmid <id> --memory <mb> [--cores <n>] [--name <name>] [--storage <name>] [--net <config>]
+proxmox vm create --node <node> --memory <mb> [--vmid <id>] [--cores <n>] \
+    [--name <name>] [--cdrom <iso>] [--net <config>] [--disk <size>] \
+    [--scsihw <type>] [--bios seabios|ovmf] [--machine <type>] [--boot <order>]
 proxmox vm start <vmid> [--node <node>]
 proxmox vm stop <vmid> [--node <node>]
 proxmox vm reboot <vmid> [--node <node>]
@@ -162,6 +164,16 @@ proxmox vm suspend <vmid> [--node <node>]
 proxmox vm resume <vmid> [--node <node>]
 proxmox vm delete <vmid> [--node <node>] [--force] [--purge]
 
+# VM snapshots
+proxmox vm snapshot list <vmid> [--node <node>]
+proxmox vm snapshot create <vmid> <snapname> [--description <text>] [--vmstate 1]
+proxmox vm snapshot show <vmid> <snapname> [--node <node>]
+proxmox vm snapshot rollback <vmid> <snapname> [--start 1]
+proxmox vm snapshot delete <vmid> <snapname> [--force 1]
+
+# VM guest agent
+proxmox vm agent interfaces <vmid> [--node <node>]
+
 # VM firewall
 proxmox vm firewall options <vmid> [--node <node>]
 proxmox vm firewall enable <vmid> [--node <node>]

{proxcli-0.8.1 → proxcli-0.8.2}/TODO.md

@@ -11,12 +11,13 @@ Completed items are marked with a check. Implementation notes are preserved for
 - [x] **Firewall management** — cluster, node, VM, and container. Options, enable/disable, policy, rules (CRUD), aliases (cluster), ipsets with CIDR mgmt (cluster), refs.
 - [x] **Pool management** — `proxmox pool`: list, show, create, update, delete. Wraps `/pools`.
 - [x] **Shell completions** — `proxmox completion bash|zsh|fish`. Dynamic, introspects the parser tree.
+- [x] **VM snapshot management** — `proxmox vm snapshot`: list, create, show, rollback, delete. Wraps `/nodes/{node}/qemu/{vmid}/snapshot`.
+- [x] **QEMU guest agent interfaces** — `proxmox vm agent interfaces <vmid>`. Wraps `/nodes/{node}/qemu/{vmid}/agent/network-get-interfaces`.
+- [x] **Streaming task logs** — `proxmox task log <upid> [--follow]`. Polls `/nodes/{node}/tasks/{upid}/log`.
+- [x] **Global flag hint** — If user places `--output` / `--dry-run` / etc. after the resource, a hint suggests the correct order.
 
 ## v1.1 — Polish & Usability
 
-- [ ] **Streaming task logs (`--follow`)**
-  - `proxmox task log <upid> --follow` that streams task output in real time (like `tail -f`). Requires httpx streaming.
-
 - [ ] **Startup time optimization**
   - Current `proxmox --help` takes ~350ms. Lazy-load subcommand modules so only the requested resource's code is imported. Move `import rich`, `import yaml` inside formatter functions. Target: <200ms.
 

{proxcli-0.8.1 → proxcli-0.8.2}/proxmox/cli/vm.py

@@ -124,6 +124,15 @@ def register_vm_parser(subparsers: argparse._SubParsersAction) -> None:
                              help="Force removal (1=yes, 0=no, default: 0)")
     snap_delete.set_defaults(func=_vm_snapshot_delete)
 
+    # --- agent ---
+    agent = vm_sub.add_parser("agent", help="Query QEMU guest agent")
+    agent_sub = agent.add_subparsers(dest="agent_action", title="agent actions", required=True)
+
+    agent_ifaces = agent_sub.add_parser("interfaces", help="List network interfaces via guest agent")
+    agent_ifaces.add_argument("vmid", type=vmid_type, help="VM ID")
+    agent_ifaces.add_argument("--node", help="Node name (auto-detected if omitted)")
+    agent_ifaces.set_defaults(func=_vm_agent_interfaces)
+
     # --- firewall ---
     fw = vm_sub.add_parser("firewall", help="Manage VM firewall")
     fw_sub = fw.add_subparsers(dest="fw_resource", title="resources", required=True)
@@ -365,6 +374,28 @@ def _vm_delete(args: argparse.Namespace, client: ProxmoxClient) -> dict:
     return result if isinstance(result, dict) else {"data": result}
 
 
+# ---------------------------------------------------------------------------
+# VM guest agent handlers
+# ---------------------------------------------------------------------------
+
+def _vm_agent_interfaces(args: argparse.Namespace, client: ProxmoxClient) -> dict | list:
+    """Retrieve network interfaces via QEMU guest agent.
+
+    Requires qemu-guest-agent installed in the VM and agent enabled in VM options.
+    """
+    node = _resolve_node(client, args.node, args.vmid)
+    if not node:
+        return {"error": f"VM {args.vmid} not found"}
+    result = client.get(f"/nodes/{node}/qemu/{args.vmid}/agent/network-get-interfaces")
+    # The result is a list of interfaces, each with 'name', 'ip-addresses', etc.
+    if isinstance(result, list):
+        for iface in result:
+            if isinstance(iface, dict):
+                iface["_node"] = node
+                iface["_vmid"] = args.vmid
+    return result
+
+
 # ---------------------------------------------------------------------------
 # VM snapshot handlers
 # ---------------------------------------------------------------------------

{proxcli-0.8.1 → proxcli-0.8.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "proxcli"
-version = "0.8.1"
+version = "0.8.2"
 description = "A CLI tool to interact with Proxmox VE nodes and clusters via the REST API"
 readme = "README.md"
 authors = [

{proxcli-0.8.1 → proxcli-0.8.2}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 2
 requires-python = ">=3.10"
 
 [[package]]
@@ -254,7 +254,7 @@ wheels = [
 
 [[package]]
 name = "proxcli"
-version = "0.8.1"
+version = "0.8.2"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },