Windsurf

Connect Thruline to Windsurf's Cascade agent through the MCP server.

Setup

1

Add the MCP server

Open Windsurf's MCP config file — ~/.codeium/windsurf/mcp_config.json on macOS/Linux, or %USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows, creating it if it doesn't exist, and add:

{
  "mcpServers": {
    "thruline": {
      "serverUrl": "https://mcp.thrulinecontext.com/mcp"
    }
  }
}

You can also add Thruline through Windsurf Settings › Cascade › MCP Servers, which writes to the same file.

2

Reload Cascade

Cascade picks up new MCP servers on the next chat session. Start a new conversation or restart Windsurf.

3

Authenticate

The first time Cascade calls a Thruline tool, you're prompted to authenticate via GitHub OAuth. Sign in with your GitHub account.

4

Index a repository

Ask Cascade to run thruline_index with your repository in owner/repo form. See Your First Index.

Using Thruline

Cascade reads Thruline's tool descriptions and decides when to call them. You can also prompt for a tool directly (for example, "Run thruline_review_changeset on my staged changes"). The Windsurf MCP config is global, so Thruline is available across every project you open, but indexing is per-repository, so each project still needs its own initial thruline_index call. The full tool list is in the MCP Tools reference.

Troubleshooting