# SuperLocalMemory

A local-first memory layer for AI agents that keeps project context on your machine. It checks facts and admits when information is missing instead of guessing.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 257
- Author: qualixar
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qualixar/superlocalmemory
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/superlocalmemory

## What it does

Agents lose their context once a session ends. Standard vector stores often pull irrelevant text snippets. SuperLocalMemory maintains a local store on your machine. In Mode A, it works without cloud API calls, Docker, or remote accounts. Text queries use a local nomic model.

You can also index screenshots, images, and PDF documents. This feature uses Google's EmbeddingGemma 2 model. It unloads after 30 minutes of inactivity. Running this media mode requires at least 16 GB of system RAM and roughly 1.5 GB of disk space.

The server connects to coding tools through the `slm` CLI or a standard stdio command. When an answer is missing, your assistant will not bluff.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add superlocalmemory -- npx -y superlocalmemory
```

### Codex

**Platform CLI**
```bash
codex mcp add superlocalmemory -- npx -y superlocalmemory
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "superlocalmemory": {
            "command": "npx",
            "args": [
                "-y",
                "superlocalmemory"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "superlocalmemory": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "superlocalmemory"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add superlocalmemory npx -y superlocalmemory
```

## When to use it
- Retain architectural decisions across different agent sessions
- Search local design screenshots and PDF specifications
- Stop coding models from hallucinating missing project rules
- Maintain persistent agent state without sending data to external APIs

## Example prompts
- Remember that we use PostgreSQL 16 for all new database tables
- Find the authentication flowchart diagram I added last Tuesday
- Check our memory for decisions regarding API rate limits

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md