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

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 **`agentops-cockpit`** (alias `agent-ops`) binaries.

---

## 🏗️ The Orchestration Engine (Primary Entry Points)
We have simplified the command surface to focus on two main workflows: **Reporting** (Batch/CI) and **Auditing** (Interactive/Dev).

| Command | Objective | Mode/Flags |
| :--- | :--- | :--- |
| `uvx agentops-cockpit report` | **Master Audit** | `--mode quick` (default) or `deep` |
| `uvx agentops-cockpit audit` | **Interactive Audit** | Standard `agent.py` optimization loop. |
| `uvx agentops-cockpit version` | **Version Check** | Display current CLI and Engine version. |
| `uvx agentops-cockpit diagnose`| **System Check** | Verify GCP Auth and environment paths. |

---

## 🧪 Specialized Shorthands
While `report` is the recommended path, these shorthands provide direct access to persona-specific logic.

| Command | Objective | Key Impact |
| :--- | :--- | :--- |
| `uvx agentops-cockpit arch` | **Architecture** | Google Well-Architected Framework scan. |
| `uvx agentops-cockpit secrets` | **Security** | Zero-trust credential hygiene scan. |
| `uvx agentops-cockpit quality` | **Quality** | Iterative Hill Climbing optimization loop. |
| `uvx agentops-cockpit red-team` | **Red Team** | Adversarial security evaluation. |
| `uvx agentops-cockpit face` | **UX/UI** | Face pillar (A2UI) protocol audit. |
| `uvx agentops-cockpit mcp-server`| **Interop** | Launch the Model Context Protocol Hub. |

---

## 🧗 High-Fidelity Filters
Use filters to isolate specific results when running a full report.

```bash
# Run only security and finops checks
uvx agentops-cockpit report --only security --only finops

# Skip heavy benchmarks for fast CI feedback
uvx agentops-cockpit report --skip quality --skip red-team
```

---

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

| Command | Objective | Flags |
| :--- | :--- | :--- |
| `uvx agentops-cockpit init` | **Trinity Scaffolder** | Scaffolds Engine + Face + Cockpit. |
| `uvx agentops-cockpit deploy` | **1-Click Cloud Run** | Audit + Build + Deploy to Cloud Run. |
| `uvx agentops-cockpit deploy-prod`| **Readiness Gate** | Full Deep Audit before production sync. |

---

## 🛡️ Registry Resilience & Failover Logic
If you encounter a **401 Unauthorized** error during `uvx`, the Cockpit automatically attempts a **Logic-Based Failover** to Public PyPI.

```bash
# Manual Override:
UV_INDEX_URL=https://pypi.org/simple uvx agentops-cockpit report
```

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