# Aletheia

Aletheia — an MCP server that keeps memory and rules for AI coders on your machine. Start it once, any tool reads it over MCP, REST or CLI — no accounts, no cloud.

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

## What it does

Aletheia runs on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and Cline. It retains what you tell an agent about your project, its architecture and your coding rules, and syncs this across sessions and tools. Memory lives in SQLite on disk; the server listens only on localhost:37790.

Setup requires Bun 1.1 or newer — the CLI and server run on it. After install, you connect Aletheia to each tool via its config. Hooks then capture facts automatically: project context, what you asked the agent to do, failures and goals. Secrets are stripped before storage, data spools to disk if the database is unreachable.

The web UI shows what Aletheia knows about each project, lets you edit facts, search them and write rules once for all tools. It replaces cloud solutions like claude-mem, but stays local and needs no provider to work.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add aletheia-mem -- npx -y aletheia-mem
```

### Codex

**Platform CLI**
```bash
codex mcp add mohamed-ashraf-elsaed-aletheia -- npx -y aletheia-mem
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mohamed-ashraf-elsaed-aletheia": {
            "command": "npx",
            "args": [
                "-y",
                "aletheia-mem"
            ]
        }
    }
}
```

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mohamed-ashraf-elsaed-aletheia npx -y aletheia-mem
```

## When to use it
- retain project context across sessions with different agents
- sync coding rules between Claude Code, Cursor and other tools
- capture errors and target states from agent sessions
- track work history: what the agent did, what it achieved, what broke

## Example prompts
- Install Aletheia and connect it to Claude Code with `claude mcp add aletheia-mem -- npx -y aletheia-mem`
- Open the web UI at http://127.0.0.1:37790 and add your project, its architecture and your rules
- On the next session the agent will recall your project and apply your written rules

## Similar
- [Titen Memory](https://affpapa.org/en/nevibecode/mcp/titen-memory.md) — MCP server · ★ 19 repo stars
- [local-rag](https://affpapa.org/en/nevibecode/plugins/local-rag.md) — plugin · ★ 30 repo stars
- [claude-peers-mcp](https://affpapa.org/en/nevibecode/skills/claude-peers-mcp.md) — skill · 1100 installs
- [request-progress](https://affpapa.org/en/nevibecode/skills/request-progress.md) — skill · 469 installs
- [cc-dm](https://affpapa.org/en/nevibecode/plugins/cc-dm.md) — plugin · ★ 22 repo stars
- [bun-sqlite](https://affpapa.org/en/nevibecode/skills/bun-sqlite.md) — skill · 538 installs

## Other versions with the same name
- [Aletheia · firatmio](https://affpapa.org/en/nevibecode/mcp/aletheia.md) — ★ 17 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
