# Aletheia

Хранит контекст проекта с привязкой к конкретным строкам кода и автоматически скрывает устаревшие факты при изменении файлов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: firatmio
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/firatmio/aletheia
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/aletheia

## Что делает

Aletheia сохраняет знания агента о проекте в виде Markdown-файлов внутри каталога `.aletheia/memories/`. Каждая запись содержит механические якоря: имя функции, совпадение строчки или наличие файла на диске. Перед тем как передать запись агенту, сервер проверяет эти факты в текущем дереве файлов.

Проверка выполняется локально без сетевых запросов и генерации эмбеддингов. Если файл или функция перемещены, инструмент отслеживает новое местоположение и помечает статус как `[moved]`. Если же код изменился и привязка сломалась, факт скрывается из контекста модели, чтобы исключить дезинформацию.

На Windows обновление через `go install` при запущенном агенте завершится ошибкой из-за блокировки файла `aletheia.exe`, поэтому процесс ассистента придётся предварительно остановить.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add aletheia -- npx -y @firatmio/aletheia
```

### Codex

**Командой платформы**
```bash
codex mcp add aletheia -- npx -y @firatmio/aletheia
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aletheia": {
            "command": "npx",
            "args": [
                "-y",
                "@firatmio/aletheia"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "aletheia": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@firatmio/aletheia"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add aletheia npx -y @firatmio/aletheia
```

## Когда брать
- сохранить контекст между сессиями работы агента
- отсеять устаревшие факты об архитектуре проекта
- направить модель на актуальные строки и функции
- отслеживать перемещение функций между файлами

## Примеры запросов агенту
- Проверь сохранённые факты о проекте и открой нужные строки для текущей задачи.
- Сохрани в память архитектурное решение по обработке скидок с привязкой к функции.
- Покажи, какие файлы изменились за прошлую сессию и требуют обновления контекста.

## Похожие
- [self-improvement](https://affpapa.org/nevibecode/skills/self-improvement.md) — скилл · 2000 установок
- [sayou](https://affpapa.org/nevibecode/mcp/sayou.md) — MCP-сервер · ★ 28
- [context-mem](https://affpapa.org/nevibecode/mcp/context-mem.md) — MCP-сервер · ★ 19
- [hipocampus](https://affpapa.org/nevibecode/plugins/hipocampus.md) — плагин · ★ 211
- [oh-my-obsidian](https://affpapa.org/nevibecode/plugins/oh-my-obsidian.md) — плагин · ★ 33
- [remember](https://affpapa.org/nevibecode/skills/rohitg00-remember.md) — скилл · 14000 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md