> ## Documentation Index
> Fetch the complete documentation index at: https://sdk.observability.getonex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

OneX governance brings AI coding assistants, including **Claude Code**, **GitHub Copilot**, and other supported tools, under the same audit and policy controls as the rest of your OneX estate. It complements [model observability](/signals): where the SDK instruments models in application code, the governance client connects your IDE assistants to OneX without code changes.

Once your tenant has governance enabled, install the **OneX Governance** graphical installer on your workstation.

## How it works

```mermaid theme={"dark"}
flowchart LR
  IDE["AI IDE / CLI\n(Claude Code, GitHub Copilot, …)"]
  Client["OneX Governance client"]
  API["OneX API\n10.243.138.252/api"]
  Dashboard["Governance dashboard"]

  IDE --> Client
  Client -->|"Secure upload"| API
  API --> Dashboard
```

Claude Code, Cursor, GitHub Copilot, and other supported assistants connect through the **Install OneX Governance** installer. Copilot in VS Code is configured automatically. No separate setup is required.

## Requirements

Before installation, confirm you have:

* A OneX tenant with governance enabled
* Your tenant ID and a **Personal token** (or forwarder secret from your operator)

<Info>
  **Personal token**: Create one under **Profile → Personal Token** in the [OneX dashboard](https://dashboard.observability.getonex.ai). Copy the full value when shown; it cannot be retrieved later.
</Info>

* The OneX API URL `http://10.243.138.252/api`, reachable from your workstation
* The governance installer for your platform ([Installation](installation))
* A supported IDE (listed below)
* Git, with your project checked out in a repository (recommended for repository context)

## Supported tools

The **Install OneX Governance** installer registers **Cursor**, **Claude Code**, and **VS Code Copilot** together. Additional tools below are supported when your organization's installer includes them.

| Tool                    | Setup                        |
| ----------------------- | ---------------------------- |
| **Claude Code**         | [Installation](installation) |
| **GitHub Copilot**      | [Installation](installation) |
| **Cursor**              | [Installation](installation) |
| **OpenAI Codex CLI**    | [Installation](installation) |
| **Windsurf**            | [Installation](installation) |
| **Gemini CLI**          | [Installation](installation) |
| **Antigravity IDE/CLI** | [Installation](installation) |
| **Kiro**                | [Installation](installation) |

Claude Desktop (the standalone chat application) is not supported at this time.

## Client packages

Installation is available through the graphical installer on **Windows** and **macOS** only.

| Platform    | Package                           | How to install                               |
| ----------- | --------------------------------- | -------------------------------------------- |
| **Windows** | `OneXGovernance-Windows.zip`      | Double-click **Install OneX Governance.exe** |
| **macOS**   | `OneXGovernance-macOS-<arch>.dmg` | Open DMG → **Install OneX Governance.app**   |

Your organization provides the build that matches your operating system and processor architecture. macOS ships separate DMGs for Apple Silicon (`arm64`) and Intel (`x86_64`).

## Model observability vs. agent governance

|                | **Model observability (SDK)**                                         | **AI agent governance**                         |
| -------------- | --------------------------------------------------------------------- | ----------------------------------------------- |
| **Scope**      | ML models in production workloads (PyTorch, TensorFlow, JAX)          | AI assistants in the IDE and terminal           |
| **Deployment** | `pip install onex-sdk` and `OneXMonitor` in your application          | **Install OneX Governance** graphical installer |
| **Dashboard**  | [Observability dashboard](https://dashboard.observability.getonex.ai) | Governance dashboard in your OneX account       |

The two products are independent and can run on the same workstation.

## Documentation

* [Deployment Overview](deployment-overview): Data flow, rollout checklist, and what users install
* [Installation](installation): Windows and macOS
* [Troubleshooting](troubleshooting): Validation and common fixes
* [Getting Started](/getting-started): Model observability with the SDK