# remem

remem keeps project knowledge available across Claude Code and Codex sessions. Use it when an agent needs to recover earlier decisions or bug-fix context.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 34
- Author: majiayu000
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/majiayu000/remem
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/remem

## What it does

remem gathers session material, turns useful parts into durable notes, and makes them searchable later. Memory is scoped to a project and can include engineering decisions, fix rationale, and preferences. It uses SQLite, with SQLCipher encryption enabled for fresh installations.

In Claude Code, hooks collect session activity and bring relevant project memory into a new session; MCP tools and a CLI are also available. Codex can capture user prompts and surface brief memory candidates. Cursor is different: its installer registers MCP only, with no automatic session capture or startup memory injection. That distinction matters if you expect background memory collection.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add remem -- npx -y @remem-ai/remem
```

### Codex

**Platform CLI**
```bash
codex mcp add remem -- npx -y @remem-ai/remem
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add remem npx -y @remem-ai/remem
```

## When to use it
- carry project decisions into a later agent session
- retrieve the reasoning behind an earlier bug fix
- restore project context in a fresh conversation
- search stored notes and session evidence

## Example prompts
- Find the earlier decision about this architecture and tell me which session recorded it.
- Search project memory for the cause of this bug and summarize the fix rationale.
- Retrieve notes related to this task and bring the relevant context into our session.

## 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