Windsurf

Windsurf is Codeium's AI-first IDE. Engrammic gives it memory that persists across sessions.

Prerequisites

• Windsurf installed
• Engrammic server running locally or cloud account

Installation

The fastest path:

curl -fsSL https://get.engrammic.ai/install.sh | sh
engrammic install

The installer detects Windsurf automatically and writes the MCP config.

Manual Configuration

Add the MCP server to ~/.codeium/windsurf/mcp_config.json:

Local server

{
  "mcpServers": {
    "engrammic": {
      "serverUrl": "http://localhost:8000/mcp"
    }
  }
}

Cloud (Engrammic hosted)

{
  "mcpServers": {
    "engrammic": {
      "serverUrl": "https://beta.engrammic.ai/mcp/"
    }
  }
}

Verify

Start a new Windsurf session and ask:

What MCP tools do you have?

You should see Engrammic tools like remember, learn, recall, trace, and link.

Load the EAG Guide

The tools alone are passive. To make Windsurf proactive with memory, load the EAG guide:

Load the engrammic onboarding pattern

This teaches the agent when to recall and store automatically.

See EAG Guide for details.

Next Steps

• EAG Guide - make memory proactive
• Memory Tools Reference - full tool documentation
• How Engrammic is Different - the epistemic approach