Onboarding: Windsurf

Add persistent memory to Windsurf's Cascade agent. Your coding assistant will retain context from past sessions and recall relevant experience when needed.

Best path: Gateway (change one URL) Time: 2 minutes Reliability: ~99%

Step 1: Get an API key

Step 2: Configure the Gateway

Set environment variables so Windsurf routes through the Hippocortex Gateway:

export OPENAI_BASE_URL="https://api.hippocortex.dev/v1"
export OPENAI_API_KEY="hx_live_..."

Add a custom header for your LLM provider key. In Windsurf settings or via environment:

export HIPPOCORTEX_LLM_API_KEY="sk-..."  # Your OpenAI or Anthropic key

Step 3: Use Windsurf normally

Every AI request now passes through the Gateway. Memory is automatic:

Past conversations and code context are captured
Relevant experience is injected into every new request
Project patterns, debugging history, and solutions persist across sessions

The Gateway runs the full pipeline: capture, synthesize (semantic search, graph retrieval, collective brain), learn, and vault — all automatically.

Step 4: Verify

After a few sessions, check dashboard.hippocortex.dev to see captured events and compiled artifacts.