Skip to main content
Install the OneX Governance client to connect Cursor, Claude Code, and VS Code Copilot to your tenant. Installation is done through the Install OneX Governance graphical installer on Windows and macOS only.

​
Requirements

Credentials: Create a Personal token under Profile → Personal Token in the OneX dashboard. Your operator may instead provide a shared forwarder secret for legacy deployments. Copy the full value when it is shown; you cannot retrieve it later.
Install as the logged-in user on your workstation. Do not run the installer as Administrator (Windows) or with sudo (macOS). Hooks, spool files, and IDE configuration are written to your user profile. The installer registers Cursor, Claude Code, and VS Code Copilot capture in one step. No additional configuration is required in the GUI.

​
What to expect

The installer opens a single window titled Install OneX Governance. Enter your connection details, click Install, and watch the Progress log for status. Install OneX Governance installer window The subtitle confirms scope: Install IDE capture for Cursor, Claude Code, and VS Code Copilot. When installation succeeds, the footer shows Installed successfully and the Progress log lists next steps (restart Cursor, Claude Code, and VS Code). Fully quit each application before reopening. A window reload is not sufficient.

​
Windows

  1. Unzip OneXGovernance-Windows.zip to a local folder (for example Downloads\OneX Governance).
  2. Double-click Install OneX Governance.exe.
  3. Enter API URL (http://10.243.138.252/api), Personal token (or forwarder secret), and Tenant, then click Install.
  4. Wait for Installed successfully in the footer and review the Progress log.
  5. Fully quit and reopen Cursor, Claude Code, and Visual Studio Code.
Do not right-click the installer and choose Run as administrator. Running as Administrator installs hooks to the wrong user profile and capture will not work.

​
macOS

  1. Open OneXGovernance-macOS-<arch>.dmg from your organization (arm64 for Apple Silicon, x86_64 for Intel).
  2. Double-click Install OneX Governance.app.
  3. Enter API URL (http://10.243.138.252/api), Personal token, and Tenant, then click Install.
  4. Wait for Installed successfully and review the Progress log.
  5. Fully quit and reopen Cursor, Claude Code, and Visual Studio Code.
If macOS blocks the app, open System Settings → Privacy & Security and click Open Anyway for the installer. Do not use sudo.

​
After installation

  1. Confirm the installer reported Installed successfully.
  2. Fully restart the IDEs you use.
  3. Exercise your assistant (Agent mode, Copilot chat, or Claude Code).
  4. Confirm events appear in the governance dashboard.
GitHub Copilot in VS Code: The installer configures the OneX VS Code extension, Copilot proxy, and capture settings automatically. No separate Copilot setup is required. The first time you open VS Code after installation, it may restart once while the extension applies its settings. This is normal.

​
Updating credentials or reinstalling

To rotate your personal token or fix a broken install, run Install OneX Governance again with the updated values. The installer overwrites hooks and client configuration in your user profile.

​
Post-install validation

Use your assistant in a normal workflow and check the governance dashboard for new events. If the dashboard stays empty after a full IDE restart, review Troubleshooting.