# ⌨️ Master Guide: AgentOps UVX Commands
## Portable Governance & Automation (v1.3)

This document provides a consolidated reference for all **`uvx`** commands available in the AgentOps ecosystem. `uvx` allows you to run these tools instantly without a local installation, making them ideal for CI/CD pipelines, ephemeral environments, and auditing external repositories.

The primary package is **`agentops-cockpit`**, which exposes the **`agent-ops`** and **`agent-ops-cockpit`** binaries.

---

## 🏗️ Master Orchestration
Run the full range of AgentOps intelligence against any project or file.

| Command | Objective | Mode/Flags |
| :--- | :--- | :--- |
| `uvx agent-ops report` | **Full Master Audit** | `--mode quick` (default) or `deep` |
| `uvx agent-ops version` | **Version Check** | Display current CLI and Engine version. |
| `uvx agent-ops diagnose`| **System Check** | Verify GCP Auth, API keys, and environment paths. |
| `uvx agent-ops email-report`| **Stakeholder Sync** | Send latest report (Usage: `agent-ops email-report user@example.com`) |

---

## 🏛️ Architecture & Interop
Audit designs against the Google Well-Architected Framework and standardized protocols.

| Command | Objective | Flags |
| :--- | :--- | :--- |
| `uvx agent-ops arch-review`| **Architecture Review**| Path defaults to `.` |
| `uvx agent-ops mcp-server` | **MCP Hub** | Start the Model Context Protocol Hub. |

---

## 🧗 AI Quality & Evaluation
Iterative science for the reasoning layer.

| Command | Objective | Impact |
| :--- | :--- | :--- |
| `uvx agent-ops quality-baseline`| **Hill Climbing** | Iterative prompt optimization loop. |
| `uvx agent-ops reliability` | **Unit Regression** | Runs core reliability suite. Use `--smoke` for E2E. |
| `uvx agent-ops smoke-test` | **Persona Journey** | Validates the "Face" pillar via interactive pipelines. |

---

## 🚩 Security & Policy
Adversarial audits and declarative guardrail enforcement.

| Command | Objective | Flags |
| :--- | :--- | :--- |
| `uvx agent-ops red-team` | **Adversarial Audit** | Path defaults to `src/agent_ops_cockpit/agent.py`. |
| `uvx agent-ops policy-audit` | **Guardrail Check** | `--text "query"` to validate against the Policy Engine. |

---

## 💰 FinOps & Infrastructure
Economic engineering and performance benchmarking.

| Command | Objective | Flags |
| :--- | :--- | :--- |
| `uvx agent-ops audit` | **Token Optimizer** | `--quick` to skip live evidence; `--no-interactive` for CI. |
| `uvx agent-ops load-test` | **Stress Benchmarking** | `--url`, `--requests`, `--concurrency`. |

---

## 🎭 UX/UI & GenUI
Auditing the "Face" pillar for protocol compliance.

| Command | Objective | Impact |
| :--- | :--- | :--- |
| `uvx agent-ops ui-audit` | **Face Auditor** | Scans frontend code for A2UI / `surfaceId` alignment. |

---

## 🚀 Scaffolding & Deployment
Initialize new projects and push to Google Cloud.

| Command | Objective | Flags |
| :--- | :--- | :--- |
| `uvx agent-ops create` | **Project Scaffolder** | `--ui a2ui/agui/flutter/lit`, `--copilotkit`. |
| `uvx agent-ops deploy` | **1-Click Deploy** | `--name`, `--region`, `--dry-run`. |
| `uvx agent-starter-pack create`| **Ecosystem Base** | Create a standard ADK engine project. |

---

## 🛠️ Performance Tip
For CI/CD scripts where you want to minimize installation latency, use the specific binary from the package:
```bash
uvx --from agentops-cockpit agent-ops report --mode deep
```

---
*Generated by the AgentOps Cockpit. Global Automation Division (v1.3).*
