How it works
Claude Code, Cursor, and most CLI agents connect through the governance client installer. GitHub Copilot in Visual Studio Code requires the OneX VS Code extension as well-see GitHub Copilot in VS Code.Requirements
Before installation, confirm you have:- A OneX tenant with governance enabled
- Your tenant ID and forwarder secret
Forwarder secret - Available in the OneX dashboard under your account.
- The API URL for your environment, reachable from your workstation
- The governance client package for your platform (Installation)
- A supported IDE or CLI (listed below)
- Git, with your project checked out in a repository (recommended for repository context)
Supported tools
Specify tools as a comma-separated list when you runinstall-client (for example claude_code,copilot).
| Tool | Install name | Setup |
|---|---|---|
| Claude Code | claude_code | Installation |
| GitHub Copilot | copilot | Installation and GitHub Copilot in VS Code |
| Cursor | cursor | Installation |
| OpenAI Codex CLI | codex | Installation |
| Windsurf | windsurf | Installation |
| Gemini CLI | gemini | Installation |
| Antigravity IDE/CLI | antigravity | Installation |
| Kiro | kiro | Installation |
Client packages
| Platform | Package | Install command |
|---|---|---|
| Windows | OneXGovernance-Portable.zip | OneXGovernance.exe install-client |
| Linux | OneXGovernance-linux-<arch>.tar.gz | ./OneXGovernance install-client |
| macOS | OneXGovernance-macos-<arch>.tar.gz | ./OneXGovernance install-client |
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 | Governance client and IDE configuration |
| Dashboard | Observability dashboard | Governance dashboard in your OneX account |
Documentation
- Installation - Windows, macOS, and Linux
- GitHub Copilot in VS Code - Extension setup for Copilot
- Troubleshooting - Validation and common fixes
- Getting Started - Model observability with the SDK
