@fredlackey/cli-proxmox 0.0.2 → 0.0.3

package/README.md

@@ -8,29 +8,30 @@ Command-line interface for [Proxmox VE](https://www.proxmox.com/en/proxmox-virtu
 npm install -g @fredlackey/cli-proxmox
 ```
 
-## Configure
+## Usage
+
+Every command accepts credentials directly as flags. No setup step is required.
 
 ```
-proxmox configure \
+proxmox vm list \
   --base-url https://pve.example.com:8006 \
   --token-id 'root@pam!terraform-token' \
-  --token-secret <secret> \
-  --default-node pm-b
-```
-
-Running `proxmox configure` without flags prompts for each value interactively. Credentials are stored in `~/.config/cli-proxmox/config.json` and that file is the only config source. There are no environment variables to set.
-
-TLS certificate verification is disabled by default since Proxmox typically uses self-signed certs. Pass `--verify-ssl` to `configure` if you have a properly signed certificate.
+  --token-secret <secret>
 
-## Usage
-
-```
-proxmox vm list
 proxmox vm clone \
+  --base-url https://pve.example.com:8006 \
+  --token-id 'root@pam!terraform-token' \
+  --token-secret <secret> \
   --vmid 9000 \
   --newid 200 \
   --name web-prod \
   --full
+```
+
+If you've already run `proxmox configure`, you can omit the credential flags:
+
+```
+proxmox vm list
 proxmox snapshot create \
   --vmid 200 \
   --snapname before-upgrade \
@@ -39,6 +40,30 @@ proxmox storage content --storage local --content iso
 proxmox task wait --upid <upid> --timeout 120
 ```
 
+## Configure (Optional)
+
+**The `configure` command is optional.** Every command accepts credentials directly as flags (e.g. `--base-url`, `--token-id`, `--token-secret`). You never need to run `configure` to use this tool. It exists as a convenience so you don't have to pass the same flags on every invocation.
+
+```
+proxmox configure \
+  --base-url https://pve.example.com:8006 \
+  --token-id 'root@pam!terraform-token' \
+  --token-secret <secret> \
+  --default-node pm-b
+```
+
+Running `proxmox configure` without flags prompts for each value interactively. Credentials are stored in `~/.config/cli-proxmox/config.json` and that file is the only config source. There are no environment variables to set.
+
+TLS certificate verification is disabled by default since Proxmox typically uses self-signed certs. Pass `--verify-ssl` to `configure` if you have a properly signed certificate.
+
+If a required credential is missing at runtime, the error tells you exactly what to do:
+
+```json
+{
+  "error": "Missing required value: --token-id. Pass it as a flag or run \"proxmox configure\"."
+}
+```
+
 ## Full Command Reference
 
 For the complete list of commands and flags, see [COMMANDS.md](COMMANDS.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fredlackey/cli-proxmox",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "AI-first CLI for managing Proxmox VE nodes, VMs, storage, and snapshots",
   "author": {
     "name": "Fred Lackey",

package/src/utils/config.js

@@ -124,7 +124,7 @@ export function resolveNode(opts, creds) {
   if (opts && opts.node) return opts.node;
   if (creds && creds.defaultNode) return creds.defaultNode;
   const err = new Error(
-    'No node specified. Pass --node <name> or set a defaultNode in ~/.config/cli-proxmox/config.json.'
+    'No node specified. Pass --node <name> or run "proxmox configure" to set a defaultNode.'
   );
   err.code = 'missing_required_value';
   err.detail = { key: 'node', flag: '--node' };