GitHub Copilot in Visual Studio Code is integrated through a dedicated OneX VS Code extension, in addition to the governance client. Complete Installation with copilot included in your --tools list before proceeding.
Setup summary
:: Install the governance client
OneXGovernance.exe install-client -y ^
--api-url https://onex-api.yourcompany.com ^
--secret YOUR_SECRET ^
--tenant your-tenant ^
--tools claude_code,copilot ^
--register-task
:: Install the VS Code extension (skipped if already installed)
OneXGovernance.exe install copilot
./OneXGovernance install-client -y \
--api-url https://onex-api.yourcompany.com \
--secret YOUR_SECRET \
--tenant your-tenant \
--tools claude_code,copilot
./OneXGovernance install copilot
Requirements
- Visual Studio Code 1.90 or later, with GitHub Copilot and Copilot Chat signed in
- Governance client installed with
copilot in --tools
- The
code command on your PATH (Command Palette → “Shell Command: Install ‘code’ command in PATH”)
VS Code extension
Including copilot in install-client installs the extension automatically when the code CLI and extension package are present. You can also install it directly:
OneXGovernance.exe install copilot
onex-governance.vsix, install it with:
code --install-extension onex-governance.vsix --force
Enabling Copilot chat governance
Standard Copilot chat (without a prefix on every message) requires a one-time enable step:
- Click Enable on the OneX prompt at first launch, or run Command Palette → “OneX: Enable built-in Copilot capture”.
- Reload the window when prompted.
- Continue using Copilot chat as usual.
Enabling built-in Copilot chat governance adjusts local network settings on your workstation. Confirm this aligns with your organization’s security policy before proceeding.
Extension settings
Under Settings → OneX Governance:
| Setting | Purpose |
|---|
onexGovernance.enabled | Enable or disable governance for the current window |
onexGovernance.captureBuiltinChat | Govern built-in Copilot chat (requires one-time consent) |
onexGovernance.exePath | Override the path to the governance client when auto-detection fails |
Validation
Confirm the OneX Governance output channel shows activity when you use Copilot or save files, then verify corresponding events in your governance dashboard.
Known issues
| Symptom | Resolution |
|---|
| No “OneX Governance” output channel | Re-run install copilot, restart VS Code, and confirm the extension is listed under Extensions |
| Extension cannot locate the client | Run install-client, or set onexGovernance.exePath in settings |
| Output shows activity; dashboard does not | Confirm the forwarder secret in the dashboard and run doctor |
@onex returns “no language model” | Verify Copilot Chat is signed in and a model is available |
| Built-in Copilot chat not governed | Run “OneX: Enable built-in Copilot capture” and reload the window |
code command not found | Install the shell command from VS Code (see Requirements) |
