Feat/cli improvements and new features cooked

.gitignore

@@ -1,6 +1,7 @@
 # Build artifacts
 bin/
 _output/
+verda
 
 # Local smoke-test output (see test/run.sh)
 tmp/
@@ -360,3 +361,15 @@ tmp-test-*/
 
 # VHS demo recordings
 vhs/
+
+# Live test script (contains local testing logic)
+scripts/live-test.sh
+
+# Claude Code local config (absolute paths, machine-specific)
+.claude/settings.json
+.claude/commands/
+.claude/topic-switch.json
+
+# AI working notes and implementation plans (not shipped)
+.ai/notes/
+docs/plans/

README.md

@@ -110,13 +110,22 @@ Auth Commands:
 
 VM Commands:
   vm                Manage VM instances
+  ssh               SSH into a running VM instance
 
 Resource Commands:
+  availability      Check instance type availability
+  images            List available OS images
+  instance-types    List instance types with specs and pricing
+  locations         List datacenter locations
   ssh-key           Manage SSH keys
   startup-script    Manage startup scripts
   volume            Manage volumes
 
+Info Commands:
+  cost              Cost estimation, pricing, and billing
+
 Other Commands:
+  completion        Generate shell completion scripts
   settings          Manage CLI settings
   update            Update Verda CLI to latest or specific version
   version           Print version information
@@ -125,23 +134,76 @@ Other Commands:
 ### VM
 
 
-| Command           | Description                                |
-| ----------------- | ------------------------------------------ |
-| `verda vm create` | Create a VM (interactive wizard or flags)  |
-| `verda vm list`   | List and inspect VM instances              |
-| `verda vm action` | Start, shutdown, hibernate, or delete a VM |
+| Command              | Description                                |
+| -------------------- | ------------------------------------------ |
+| `verda vm create`    | Create a VM (interactive wizard or flags)  |
+| `verda vm list`      | List and inspect VM instances              |
+| `verda vm describe`  | Show detailed info about a single VM       |
+| `verda vm action`    | Start, shutdown, hibernate, or delete a VM |
+
+
+### SSH
+
+```bash
+# Connect by hostname
+verda ssh gpu-runner
 
+# Connect with options
+verda ssh gpu-runner --user ubuntu --key ~/.ssh/id_ed25519
+
+# Port forwarding and other ssh args
+verda ssh gpu-runner -- -L 8080:localhost:8080
+```
 
 ### Volume
 
 
-| Command               | Description                                  |
-| --------------------- | -------------------------------------------- |
-| `verda volume create` | Create a block storage volume                |
-| `verda volume list`   | List volumes                                 |
-| `verda volume action` | Detach, rename, resize, clone, or delete     |
-| `verda volume trash`  | List deleted volumes (restorable within 96h) |
+| Command                 | Description                                  |
+| ----------------------- | -------------------------------------------- |
+| `verda volume create`   | Create a block storage volume                |
+| `verda volume list`     | List volumes                                 |
+| `verda volume describe` | Show detailed info about a single volume     |
+| `verda volume action`   | Detach, rename, resize, clone, or delete     |
+| `verda volume trash`    | List deleted volumes (restorable within 96h) |
+
+
+### Instance Types, Images, Locations & Availability
 
+```bash
+# Browse instance types with specs and pricing
+verda instance-types
+verda instance-types --gpu             # GPU only
+verda instance-types --cpu             # CPU only
+verda instance-types --spot            # spot pricing
+
+# List all OS images
+verda images
+verda images --type 1V100.6V          # compatible with instance type
+verda images --category ubuntu         # filter by category
+
+# List datacenter locations
+verda locations
+
+# Check capacity
+verda availability                     # full matrix
+verda availability --location FIN-01   # specific location
+verda availability --type 1V100.6V     # specific type
+verda availability --spot              # spot only
+```
+
+### Cost & Billing
+
+```bash
+# Estimate costs before creating
+verda cost estimate --type 1V100.6V --os-volume 100 --storage 500
+verda cost estimate --type 1V100.6V --spot
+
+# See what your running instances are costing you
+verda cost running
+
+# Account balance
+verda cost balance
+```
 
 ### SSH Keys & Startup Scripts
 
@@ -183,15 +245,54 @@ Available themes: `default`, `dracula`, `catppuccin`, `catppuccin-latte`, `nord`
 | `verda auth use PROFILE` | Switch active auth profile                |
 
 
+### Shell Completion
+
+```bash
+# Bash
+source <(verda completion bash)
+
+# Zsh (add to ~/.zshrc or run once)
+verda completion zsh > "${fpath[1]}/_verda"
+
+# Fish
+verda completion fish | source
+```
+
 ## Global Flags
 
 
-| Flag         | Description                                           |
-| ------------ | ----------------------------------------------------- |
-| `--debug`    | Enable debug output (API request/response details)    |
-| `--timeout`  | HTTP request timeout (default: 30s)                   |
-| `--base-url` | Override API base URL                                 |
-| `--config`   | Path to config file (default: `~/.verda/config.yaml`) |
+| Flag              | Description                                           |
+| ----------------- | ----------------------------------------------------- |
+| `--output, -o`    | Output format: `table`, `json`, `yaml` (default: table) |
+| `--debug`         | Enable debug output (API request/response details)    |
+| `--timeout`       | HTTP request timeout (default: 30s)                   |
+| `--base-url`      | Override API base URL                                 |
+| `--config`        | Path to config file (default: `~/.verda/config.yaml`) |
+
+### Structured Output
+
+All list and describe commands support `--output json` and `--output yaml` for scripting:
+
+```bash
+# Pipe to jq
+verda vm list -o json | jq '.[].hostname'
+
+# YAML output
+verda volume describe vol-123 -o yaml
+
+# Use in CI/CD scripts
+INSTANCE_ID=$(verda vm list -o json | jq -r '.[0].id')
+```
+
+### Wait for Operations
+
+Async commands support `--wait` to poll until completion:
+
+```bash
+verda vm create --hostname gpu-runner --wait --wait-timeout 10m
+verda vm action --id abc-123 --wait
+verda volume create --name data --size 500 --wait
+```
 
 
 ## Configuration

go.mod

@@ -13,7 +13,10 @@ require (
 	go.yaml.in/yaml/v3 v3.0.4
 )
 
-require gopkg.in/ini.v1 v1.67.1
+require (
+	github.com/charmbracelet/x/term v0.2.2
+	gopkg.in/ini.v1 v1.67.1
+)
 
 require (
 	charm.land/bubbles/v2 v2.1.0 // indirect
@@ -23,7 +26,6 @@ require (
 	github.com/charmbracelet/harmonica v0.2.0 // indirect
 	github.com/charmbracelet/ultraviolet v0.0.0-20260205113103-524a6607adb8 // indirect
 	github.com/charmbracelet/x/ansi v0.11.6 // indirect
-	github.com/charmbracelet/x/term v0.2.2 // indirect
 	github.com/charmbracelet/x/termios v0.1.1 // indirect
 	github.com/charmbracelet/x/windows v0.2.2 // indirect
 	github.com/clipperhouse/displaywidth v0.11.0 // indirect