Add Memory to Windsurf
Give your Windsurf agent persistent memory in 2 minutes. Install OMEGA, add one config file, and your agent remembers decisions, preferences, and context across every session.
Step-by-Step Guide
Install OMEGA
Install the OMEGA memory package from PyPI. Requires Python 3.11 or later.
pip install omega-memoryNo API keys, no Docker, no external databases. Zero dependencies beyond Python itself.
Add MCP configuration to Windsurf
Open your Windsurf MCP settings and add the OMEGA server configuration.
// ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"omega-memory": {
"command": "python3.11",
"args": ["-m", "omega", "serve"]
}
}
}Windsurf reads this configuration on startup. Restart Windsurf after saving the file.
Verify the connection
Open a new Windsurf session and ask the agent to list its available memory tools.
Prompt: "What OMEGA memory tools do you have access to?"The agent should report 25 MCP tools including omega_store, omega_query, omega_reflect, and omega_protocol.
Initialize the protocol
Ask the agent to run the OMEGA welcome and protocol setup to load your memory context.
Prompt: "Run omega_welcome and omega_protocol to initialize your memory."After initialization, the agent has access to all prior memories and will store new ones automatically.
What You Get
Cross-session memory
Decisions, preferences, and lessons persist between Windsurf sessions
Auto-capture via hooks
OMEGA hooks capture context automatically as you work
Semantic search
The agent finds relevant memories using hybrid BM25 + semantic search
Contradiction detection
OMEGA flags when new information contradicts existing memories
Intelligent forgetting
Outdated or low-value memories decay naturally over time
AES-256 encryption
All memories are encrypted at rest on your local machine
Frequently Asked
Does Windsurf support MCP servers?
Yes. Windsurf supports MCP servers through its configuration file at ~/.codeium/windsurf/mcp_config.json. You can add any MCP-compatible server, including OMEGA, and the agent will have access to its tools.
Where is my memory data stored?
All memory data is stored locally on your machine in a SQLite database, typically at ~/.omega/memory.db. Nothing is sent to any cloud service. OMEGA encrypts the data at rest with AES-256.
Can I share memory between Windsurf and other editors?
Yes. OMEGA stores all memories in a single local database. Configure the same MCP server in Windsurf, Cursor, and Claude Code, and they all share the same persistent memory. See our guide on sharing memory across editors.
Will this affect Windsurf's Cascade performance?
No. OMEGA runs as a separate process and communicates via the MCP protocol. Memory operations are fast (local SQLite + ONNX) and asynchronous, so they don't interfere with Cascade's primary workflow.
Windsurf + Memory
Two minutes to install. Infinite sessions of context.