# How to give Windsurf better memory Windsurf keeps context across Cascade conversations with two mechanisms, auto-generated memories and manually defined rules ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). Memories are tied to the workspace where they were created, and rules files are capped at 12000 characters each ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). KnowMan keeps a personal library of [saved reading](https://www.knowman.io/guides/ai-article-saver), decisions and playbooks that agents can query through its local stdio MCP server ([MCP server guide](https://www.knowman.io/guides/mcp-server-knowledge-base)). ## What Windsurf memory is Memories is Windsurf's system for sharing and persisting context across conversations ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). There are two mechanisms. Cascade can automatically generate Memories, and you can manually define rules at the local and global levels. You reach both through the Customizations icon in the top right slider menu in Cascade, or via Windsurf Settings in the bottom-right corner ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). ## How auto-generated memories work During a conversation, Cascade can automatically generate and store memories when it encounters context it believes is useful to remember. Autogenerated memories are associated with the workspace where they were created, and Cascade retrieves them when it believes they are relevant. Creating and using auto-generated memories does not consume credits ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). ## Ask Cascade to remember something You do not have to wait for Cascade to decide. You can ask Cascade to create a memory at any time. Just prompt Cascade to "create a memory of ..." ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). Use it for preferences or decisions you want carried into later conversations in the same workspace. ## Write rules Cascade follows Rules are instructions you explicitly define for Cascade to follow. They work at two levels. [Global rules](https://www.knowman.io/guides/knowledge-base-for-ai-agents) live in global_rules.md and apply across all workspaces. Workspace rules live in the .windsurf/rules directory and can be tied to globs or natural language descriptions. Windsurf automatically discovers rules from multiple locations, and in git repositories it also searches up to the git root to find rules in parent directories. When you create a new rule, it is saved in the .windsurf/rules directory of your current workspace, not necessarily at the git root ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). ## Rules limits and activation modes Each rules file is limited to 12000 characters. Windsurf rules support four activation modes. Always On applies a rule at all times. Model Decision lets the model decide whether to apply the rule, based on a natural language description you write. Glob applies a rule to all files matching a pattern you define (e.g. .js or src/**/ *.ts). Keep rules simple, concise, and specific, because rules that are too long or vague may confuse Cascade. The Windsurf team also curates example rule templates at windsurf.com/editor/directory ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). ## System rules for organizations Enterprise organizations can deploy system-level rules that apply globally across all workspaces and cannot be modified by end users without administrator permissions. System-level rules are merged with workspace and global rules, so they add context without overriding what users defined ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). For individual use, global rules in global_rules.md apply across all workspaces ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). ## Where KnowMan fits Memories keep workspace context and rules keep instructions, both inside Windsurf ([Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories)). KnowMan adds a [personal library beside the editor](https://www.knowman.io/guides/personal-knowledge-base). It saves articles and links, reads and tags them, [answers questions](https://www.knowman.io/guides/ai-knowledge-base) with citations, and keeps memories as claims, decisions and playbooks ([persistent memory for AI agents](https://www.knowman.io/guides/persistent-memory-for-ai-agents)). Its MCP server runs locally with `npx -y @knowman/mcp` on Node 22 or newer, or as a hosted server at https://api.knowman.io/mcp. Tools include kb_search for [saved items](https://www.knowman.io/guides/how-to-save-articles), kb_ask for cited answers and kb_memories for saved claims, decisions and playbooks. The [local server](https://www.knowman.io/guides/what-is-an-mcp-server) talks to KnowMan's HTTP API with a Bearer key in KNOWMAN_API_KEY, created at Settings > Connections > Connect an AI agent in the web app. The hosted server supports OAuth sign-in on the KnowMan consent page or an API key sent as an `Authorization: Bearer ` header. KnowMan documents client configs for Claude Desktop, Claude Code and Cursor ([MCP server guide](https://www.knowman.io/guides/mcp-server-knowledge-base)). ## Use the hosted KnowMan server To use KnowMan from a client that supports remote MCP servers, add https://api.knowman.io/mcp. Sign in with OAuth on the KnowMan consent page, or create an API key in KnowMan settings and send it as an `Authorization: Bearer ` header. The open-source client is available on [GitHub](https://github.com/Essatt/knowman-mcp). Ask the assistant to search or save information, such as "search my KnowMan for ..." or "save this URL". ## Questions ### Does Windsurf have memory? Yes. Memories is Windsurf's system for sharing and persisting context across conversations, with two mechanisms: auto-generated Memories and manually defined rules. See [Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories). ### How do I make Windsurf remember something? Prompt Cascade to "create a memory of ..." and it will store it. Rules are the manual alternative, defined at the global or workspace level. See [Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories). ### Do Windsurf memories work across workspaces? No. Memories generated in one workspace will not be available in another. Cascade retrieves them when it believes they are relevant. See [Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories). ### Do Windsurf memories cost credits? No. Creating and using auto-generated memories does not consume credits. See [Windsurf docs](https://web.archive.org/web/20260115004211/https://docs.windsurf.com/windsurf/cascade/memories). ## Related guides - [Connect your knowledge base through KnowMan's MCP server](https://www.knowman.io/guides/mcp-server-knowledge-base) - [Persistent Memory for AI Agents](https://www.knowman.io/guides/persistent-memory-for-ai-agents) - [How to Give Your AI Context from What You Read](https://www.knowman.io/guides/give-your-ai-context) - [How Do You Connect AI to Your Notes?](https://www.knowman.io/guides/connect-any-ai-to-your-notes) ## More in this topic - [How to give Grok Bot better memory](https://www.knowman.io/guides/grok-bot-memory) - [How to give Google Antigravity better memory](https://www.knowman.io/guides/antigravity-memory) - [Give Copilot Studio agents better memory](https://www.knowman.io/guides/copilot-studio-memory) ## More for Windsurf - [KnowMan MCP server for Windsurf](https://www.knowman.io/integrations/windsurf) - [How to teach Windsurf your knowledge](https://www.knowman.io/guides/teach-windsurf-your-knowledge) ## Keep the knowledge, not just the context KnowMan keeps your saved reading, decisions and playbooks in one library an agent can query. Try Pro free for 14 days, no credit card. [Create your account](https://app.knowman.io/signup) [Start free](https://app.knowman.io/signup) Every new account starts with 14 days of Pro. No credit card. Source: https://www.knowman.io/guides/windsurf-memory