# rememb

Local memory for AI agents: project entries, keyword search and version history. No cloud, no API keys.

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

## What it does

\`rememb` keeps project context in a local store at `~/.rememb/` — `entries.json` by default, with `meta.json` and `config.json` beside it. An agent loads earlier decisions when a session starts, writes new ones as things change, and searches by keyword when it needs a narrow recall. Matching runs over entry text and tags; there are no embeddings and no calls to an outside service.

Entries live in sections: `project`, `actions`, `systems`, `requests`, `user`, `context`. Edits keep history, so you get diffs, restore of an earlier version and an audit trail. Limits, section list and storage backend sit in `config.json`; switch `storage_backend` to `sqlite` for bigger stores and existing JSON entries migrate on their own.

Install with `pip install rememb`; in MCP mode the store initializes on first use. A separate SSE transport (`rememb mcp --transport sse --host 127.0.0.1 --port 8765`) is for sharing one running process across several MCP clients on the same machine. Keep it out of a stdio client config — those clients expect JSON-RPC over stdin/stdout, while SSE serves an HTTP endpoint and starts on its own.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add rememb -- uvx rememb
```
uvx runs the command named after the package; if the README names another one, use uvx --from rememb <command>

### Codex

**Platform CLI**
```bash
codex mcp add rememb -- uvx rememb
```
uvx runs the command named after the package; if the README names another one, use uvx --from rememb <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rememb": {
            "command": "uvx",
            "args": [
                "rememb"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from rememb <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "rememb": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "rememb"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from rememb <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add rememb uvx rememb
```
uvx runs the command named after the package; if the README names another one, use uvx --from rememb <command>

## When to use it
- stop re-explaining the stack and folder layout at the start of every session
- pull up an earlier decision by keyword instead of rereading everything
- roll a memory entry back to its previous version after a bad edit
- see what the agent wrote to memory and when
- keep a separate store per repository

## Example prompts
- Save to rememb that the backend is PostgreSQL and auth lives in `src/auth/`
- Search memory for anything about database migrations
- Show me which entries changed this session

## Similar
- [remember](https://affpapa.org/en/nevibecode/skills/rohitg00-remember.md) — skill · 14000 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/rohitg00-handoff.md) — skill · 13400 installs
- [how-it-works](https://affpapa.org/en/nevibecode/skills/how-it-works.md) — skill · 5100 installs
- [wrap-up](https://affpapa.org/en/nevibecode/skills/codewithmukesh-wrap-up.md) — skill · 2800 installs
- [claude-memory-curator](https://affpapa.org/en/nevibecode/skills/claude-memory-curator.md) — skill · 2600 installs
- [self-improvement](https://affpapa.org/en/nevibecode/skills/self-improvement.md) — skill · 2000 installs

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