# plur

Local storage engine for AI agents that keeps project rules, preferences, and architecture decisions in plain YAML files across tools.

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

## What it does

The server keeps agent memory on your local drive under `~/.plur/`. Records are saved as transparent YAML entries called engrams. You can inspect every piece of recalled knowledge, adjust entries in any text editor, or wipe them clean without touching model weights.

Node.js 20 or newer is strictly required. Without it, the binary will fail during startup. Retrieval uses the local `BGE-small` model by default. If your machine blocks model downloads, search gracefully falls back to standard BM25 keyword matching.

Scoping prevents team conventions from colliding with private notes. Generating a `.plur.yaml` config through `--scope` confines specific project details to their directory while retaining global developer preferences.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- retain coding style corrections across separate coding sessions
- share architectural context between Claude Code, Cursor, and Codex
- keep developer preferences on local disk in plain YAML
- isolate client project memories using dedicated scopes

## Example prompts
- Save our database schema decisions to plur memory
- Check plur memory for the testing conventions we established earlier
- Retrieve all saved engrams tagged under project:my-app

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