Viam Cli

# Comprehensive Viam CLI Management Skill

This skill allows the agent to interact with the Viam robotics platform across all available CLI surfaces, including initial setup, deployment, data management, and the local developer loop.

## Security & Scoping Guardrails
* **No hardcoded credentials:** Never ask the user to paste an API key or Token into the chat. Rely on OpenClaw's environment variable injection. If unauthenticated, instruct the user to run `viam login` in their secure terminal.
* **Read-first approach:** Always prefer listing resources (e.g., `list`, `describe`) before attempting mutations or deletions.
* **Destructive operations:** Always confirm with the user before running any `delete` command across datasets, data pipelines, or machine data.

---

## Initialization & Installation (First-Time Setup)

Before attempting to run any `viam` commands, verify if the CLI is installed by running `viam version` or checking the system path. 

**If the `viam` CLI is NOT installed:**
1. **STOP and ask for permission:** You must explicitly ask the user: *"The Viam CLI is not installed on your system. Would you like me to install it via Homebrew?"*
2. **Execute Installation (Upon Approval Only):** If the user grants permission, run the following commands sequentially:
   * `brew tap viamrobotics/brews`
   * `brew install viam`
3. **Verify:** Once installed, run `viam version` to confirm success, then instruct the user to run `viam login` to authenticate.

---

## Complete Viam CLI Command Reference

### Authentication & Profiles
* `viam login` - Authenticates the session (opens a browser or returns a URL).
* `viam login api-key --key-id <id> --key <secret>` - Authenticates non-interactively via API key.
* `viam logout` - Logs out of the current Viam session.
* `viam whoami` - Displays the current authenticated profile/user.
* `viam profiles` - Manages local CLI profiles.

### Organizations & Locations
* `viam organizations list` - Lists all organizations the user...