# Holographic Memory

Holographic Memory is an MCP server for Claude Code that stores persistent agent memory locally, with hybrid search, fact forgetting, and optional disk encryption.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23 repo stars
- Author: writerslogic
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/writerslogic/holographic-memory
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/holographic-memory

## What it does

This server manages persistent storage for coding agents right on your hard drive. Built on Rust, the core combines keyword matching via BM25, graph vector indexing, and symbolic fact operations. It exposes tools for `remember`, `recall`, `forget`, and `explain`. Expired knowledge gets superseded properly, and forget commands wipe data rather than masking it.

All records reside in a local directory using crash-safe journals and checkpoints. You can turn on AES-256-GCM encryption and signed audit logging whenever sensitive records require protection. The tool stays completely offline. It issues no telemetry pings and requires no remote services.

The storage engine permits only one active writer per store directory. Running concurrent write tasks from separate processes will trigger lock conflicts.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add holographic-memory-mcp -- npx -y holographic-memory-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add holographic-memory -- npx -y holographic-memory-mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add holographic-memory npx -y holographic-memory-mcp
```

## When to use it
- retain agent facts and decisions across editor sessions
- purge obsolete facts with explicit `forget` operations
- query stored context through hybrid text and vector retrieval
- persist conversation notes locally under AES-256-GCM encryption

## Example prompts
- Remember that this repository requires Node.js 20 and pnpm
- Recall what we decided regarding the authentication flow earlier
- Forget the previous staging database credentials

## Similar
- [memory-lancedb-pro](https://affpapa.org/en/nevibecode/skills/memory-lancedb-pro.md) — skill · 647 installs
- [Echo Memory](https://affpapa.org/en/nevibecode/mcp/echo-memory.md) — MCP server · ★ 2 repo stars
- [v3-memory-specialist](https://affpapa.org/en/nevibecode/agents/v3-memory-specialist.md) — subagent · ★ 850 repo stars
- [memory-specialist](https://affpapa.org/en/nevibecode/agents/memory-specialist.md) — subagent · ★ 189 repo stars
- [V3 Memory Unification](https://affpapa.org/en/nevibecode/skills/v3-memory-unification.md) — skill · 1100 installs
- [VelesDB Memory](https://affpapa.org/en/nevibecode/mcp/velesdb-memory.md) — MCP server · ★ 105 repo stars

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