Give Your Coding Assistant Memory in Two Minutes

Session one: tell it something

Remember that this project deploys
with rsync to the staging box first,
never straight to production.

Expected: the assistant calls save_memory and confirms what it stored. Phrase it as a rule ("never ...") and it can call save_rule instead, which surfaces in every session and is enforced by Guard.

Session two: ask what it knows

What do you remember about
how this project deploys?

Expected: at the start of the new session the assistant calls get_project_context and loads the top memories for this project; for the question it calls recall_memories and answers with the rsync-to-staging fact, citing it as a memory.

Then stop thinking about it

From here on, saving is automatic: context is captured before a compaction and restored after it, and facts you state while working are saved without being asked. Memories are scoped per project by git remote, with global ones for your own preferences.

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Cursor Settings, then MCP, then Add new MCP server, or edit the file directly. Restart Cursor; the tools appear in agent mode.

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cogmemai": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
    }
  }
}

Windsurf Settings, then Cascade, then MCP, then Add Server, or edit the file directly. Restart Windsurf; the tools work with Cascade in agent mode.

Cline (VS Code)

Cline MCP Settings

{
  "cogmemai": {
    "command": "npx",
    "args": ["-y", "cogmemai-mcp"],
    "env": { "COGMEMAI_API_KEY": "cm_your_api_key_here" }
  }
}

VS Code, then the Cline extension, then MCP Servers (gear icon), then Edit MCP Settings. Cline detects the new server; toggle it on and approve the tools when prompted.

Continue

~/.continue/config.yaml

mcpServers:
  - name: cogmemai
    command: npx
    args: ["-y", "cogmemai-mcp"]
    env:
      COGMEMAI_API_KEY: cm_your_api_key_here

VS Code, then the Continue extension, then the gear icon to edit config.yaml. Reload the VS Code window; Continue picks up the tools automatically.