Skip to main content
This page covers validation steps and resolutions for the governance client. Start with Installation if the client is not yet deployed. For Visual Studio Code and Copilot, see GitHub Copilot in VS Code.

​
Validation checklist

  1. Run status and confirm the client reports a healthy configuration.
  2. Fully restart the IDE or Visual Studio Code (a reload is not sufficient).
  3. Use your assistant in a representative workflow—Agent mode, Copilot chat, or Claude Code CLI.
  4. Review the governance dashboard for new events.
When the dashboard remains empty, run doctor and confirm the API URL and forwarder secret in the OneX dashboard.

​
Common issues

IssueResolution
API connection failureVerify API URL, forwarder secret, and outbound network access
No dashboard activityFull IDE restart, then doctor; re-run install-client if needed
HTTP 401 on uploadRegenerate the forwarder secret in the dashboard and reinstall the client
Failure after IDE upgradeRe-run install-client with your current tool list
macOS blocks the clientApprove under System Settings → Privacy & Security, or remove the quarantine flag on the extracted bundle

​
Credential rotation

Handle the forwarder secret as you would any service credential. If it may have been exposed, regenerate it in your OneX dashboard account and run install-client with the updated value.

​
Command reference

ActionWindowsmacOS / Linux
StatusOneXGovernance.exe status./OneXGovernance status
DoctorOneXGovernance.exe doctor./OneXGovernance doctor
UninstallOneXGovernance.exe install-client --uninstall./OneXGovernance install-client --uninstall
The status command reports the installed client path on your workstation.