Skip to content

← All guides

Archive memory guide

This Windsurf guide is preserved for existing users. Memory is now supporting infrastructure under the production-action control product.

Current offersRisk Review

How to Add Persistent Memory to Windsurf

Windsurf is one of the fastest-growing AI code editors, but it loses project context between sessions. The Novyx MCP Server gives Windsurf persistent memory — your AI assistant remembers your codebase, architecture decisions, and coding preferences across every session.

The Problem

  • ✗ Windsurf forgets project context when you close a session
  • ✗ You re-explain coding conventions and architecture every time
  • ✗ No way to search past decisions or code rationale
  • ✗ No rollback if the AI learns something wrong about your codebase

The Solution: Novyx MCP Server

The Novyx MCP Server exposes memory tools to Windsurf via the Model Context Protocol. Windsurf can store decisions, recall past context, preserve audit context, and recover supported state — all persisted across sessions.

Setup

1. Install the MCP server:

bash
pip install novyx-mcp

2. Add to your Windsurf MCP config:

json
{
  "mcpServers": {
    "novyx-memory": {
      "command": "python",
      "args": ["-m", "novyx_mcp"],
      "env": { "NOVYX_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Add this to your Windsurf MCP settings or the mcp_config.json in your project root.

What Windsurf Can Do With Memory

Remember project architecture

"This project uses Next.js App Router with server components." — stored permanently across all sessions.

Recall coding standards

"What test framework does this project use?" — instant recall from past sessions, no re-explaining needed.

Track technical decisions

"We chose Drizzle over Prisma for edge compatibility." — never re-justify the same decision twice.

Review mistakes

"Show what changed after I told it to refactor to classes." — supported recovery context with audit history.

MCP Tools Available

CategoryTools
Core Memoryremember, recall, forget, list_memories, memory_stats, rollback, audit, link_memories, add_triple, query_triples
Context Spacescreate_space, list_spaces, space_memories, update_space, delete_space, share_space
Replayreplay_timeline, replay_snapshot, replay_lifecycle, replay_diff
Experimental maintenanceOptional memory-maintenance helpers where enabled

See the full MCP server docs on the Integrations page.

Frequently Asked Questions

How do I add persistent memory to Windsurf?

Install novyx-mcp and add it to your Windsurf MCP configuration. Windsurf gains MCP memory tools so coding sessions can persist across restarts with semantic search and supported recovery workflows.

Does Windsurf support MCP servers?

Yes. Windsurf supports the Model Context Protocol. You can add MCP servers in the Windsurf settings under the MCP section, or in your project-level configuration file.

Can Windsurf remember my project context between sessions?

Not by default. Windsurf resets context when you close the editor. The Novyx MCP server gives Windsurf persistent memory that survives restarts and enables cross-project knowledge sharing.

Start with the production-action gate

For the current product path, start with a governed production action.

Run the gate