Windsurf

Configure Windsurf AI code editor to use agentgateway running in Kubernetes

Configure Windsurf, the AI code editor by Codeium, to route requests to your LLM through your agentgateway proxy.

Before you begin

1. Set up an agentgateway proxy.
2. Set up access to the OpenAI LLM provider.

Get the gateway URL

export INGRESS_GW_ADDRESS=$(kubectl get svc -n agentgateway-system agentgateway-proxy \
  -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

echo "Gateway address: $INGRESS_GW_ADDRESS"

export INGRESS_GW_ADDRESS=$(kubectl get svc -n agentgateway-system agentgateway-proxy \
  -o jsonpath='{.status.loadBalancer.ingress[0].hostname}')

echo "Gateway address: $INGRESS_GW_ADDRESS"

kubectl port-forward -n agentgateway-system svc/agentgateway-proxy 8080:80

Configure Windsurf

Configure Windsurf to route LLM requests through agentgateway. For more information, review the Windsurf documentation.

1. Open Windsurf Settings.

   • macOS: Cmd + , or Windsurf > Settings
   • Windows/Linux: Ctrl + , or File > Preferences > Settings

2. Search for Http: Proxy.

3. Enter your agentgateway URL.

   http://<INGRESS_GW_ADDRESS>/<route-path>

   For example, if your HTTPRoute uses path /openai on your ai-example.com secured host, use https://ai-example.com/openai.

4. Save the settings.

Verify the connection

1. Open the Windsurf chat panel.
2. Send a message such as “test”.
3. Windsurf responds through your agentgateway backend.