json config

Windsurf

Add a JSON config block to .windsurf/settings.json. Restart Windsurf and governance is live.

API key required

You need a Neptrix API key to complete this setup. API keys come with hosted beta access, and the hosted platform is currently in closed beta. Join the waitlist for access.

Installation

1Copy the configuration below
2Create or open .windsurf/settings.json in your project root
3Replace YOUR_API_KEY with your key
4Restart Windsurf to apply

Add this configuration to.windsurf/settings.json

.windsurf/settings.json

1{
2  "governance": {
3    "preToolUse": {
4      "endpoint": "https://qpthort-backend-production.up.railway.app/hooks/claude-code/pre-tool-use",
5      "headers": {
6        "x-api-key": "YOUR_API_KEY"
7      }
8    }
9  }
10}

Replace YOUR_API_KEY with your API key. Join the waitlist for hosted access.

How it works

Agent proposes action

Before each tool call, your agent sends the proposed action to Neptrix for evaluation.

Neptrix evaluates

Constitutional governance rules evaluate the action. The decision is logged to your audit trail.

Decision returned

ALLOW, BLOCK, ESCALATE, or MODIFY. Agents auto-discover — no registration needed.

The hosted platform is in closed beta.

Join the waitlist for first access when it reopens - or download the desktop beta and govern your agents on your own machine today.

Download the desktop beta Join the waitlist