Setup Pare with Windsurf

April 5, 2026 ยท View on GitHub

# 1. Install Pare servers
npx @paretools/init --client windsurf --preset web

# 2. Add agent rules
cp node_modules/@paretools/init/rules/.windsurfrules .windsurfrules

# 3. Restart Windsurf

# 4. Validate
npx @paretools/init doctor

Available presets: web, python, rust, go, jvm, dotnet, ruby, swift, mobile, devops, full โ€” see the Quickstart Guide for preset details.

Manual Configuration

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pare-git": {
      "command": "npx",
      "args": ["-y", "@paretools/git"]
    },
    "pare-test": {
      "command": "npx",
      "args": ["-y", "@paretools/test"]
    }
  }
}
Windows

On Windows, wrap npx with cmd /c:

{
  "mcpServers": {
    "pare-git": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@paretools/git"]
    }
  }
}

Agent Rules

Copy the Windsurf rules file to your project root:

cp node_modules/@paretools/init/rules/.windsurfrules .windsurfrules

The file must stay under 6,000 characters (it currently uses ~1,800).

Verify

Restart Windsurf after editing the config. Use npx @paretools/init doctor to confirm servers are reachable.