# Piia Engram

Локальный слой идентичности: агент видит ваши предпочтения, решения и контекст проекта. Работает поверх нескольких MCP-инструментов.

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

## Что делает

Piia Engram хранит ваши рабочие предпочтения, планку качества, выводы из прошлых задач и контекст проектов в локальных файлах под `~/.engram/` в виде JSON и Markdown. Несколько агентов — Claude, Codex, Cursor, Windsurf — читают один и тот же набор, поэтому не переспрашивают заново, какой у вас фреймворк и как вы тестируете.

Записи предлагает ИИ, но применяете их вы. Опасные изменения — учётные данные, команды оболочки, настройки MCP, правила доступа — ждут вашего подтверждения; остальное поглощается само, с возможностью отката. Переменная `ENGRAM_APPROVAL=strict` переводит в режим подтверждения каждую запись. Посмотреть, что именно уйдёт агенту, можно командой `engram preview --html` — она показывает и то, что скрыто политикой.

Установка начинается с `pip install piia-engram && engram setup`. Мастер сам находит установленные инструменты, перечисляет конфиги, которые собирается править, и делает резервные копии перед записью. Нужен Python 3.10 или новее. Если отказаться на шаге подтверждения, ничего не изменится.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `ENGRAM_MCP_STARTUP_SYNC`, `ENGRAM_TOOLS`, `PYTHONIOENCODING` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ENGRAM_MCP_STARTUP_SYNC=<ENGRAM_MCP_STARTUP_SYNC> --env ENGRAM_TOOLS=<ENGRAM_TOOLS> --env PYTHONIOENCODING=<PYTHONIOENCODING> --transport stdio piia-engram -- uvx piia-engram
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from piia-engram <команда>

### Codex

**Командой платформы**
```bash
codex mcp add piia-engram --env ENGRAM_MCP_STARTUP_SYNC=<ENGRAM_MCP_STARTUP_SYNC> --env ENGRAM_TOOLS=<ENGRAM_TOOLS> --env PYTHONIOENCODING=<PYTHONIOENCODING> -- uvx piia-engram
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from piia-engram <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "piia-engram": {
            "command": "uvx",
            "args": [
                "piia-engram"
            ],
            "env": {
                "ENGRAM_MCP_STARTUP_SYNC": "<ENGRAM_MCP_STARTUP_SYNC>",
                "ENGRAM_TOOLS": "<ENGRAM_TOOLS>",
                "PYTHONIOENCODING": "<PYTHONIOENCODING>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from piia-engram <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "piia-engram": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "piia-engram"
            ],
            "env": {
                "ENGRAM_MCP_STARTUP_SYNC": "<ENGRAM_MCP_STARTUP_SYNC>",
                "ENGRAM_TOOLS": "<ENGRAM_TOOLS>",
                "PYTHONIOENCODING": "<PYTHONIOENCODING>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from piia-engram <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ENGRAM_MCP_STARTUP_SYNC=<ENGRAM_MCP_STARTUP_SYNC> -e ENGRAM_TOOLS=<ENGRAM_TOOLS> -e PYTHONIOENCODING=<PYTHONIOENCODING> piia-engram uvx piia-engram
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from piia-engram <команда>

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

## Примеры запросов агенту
- Помоги отрефакторить модуль авторизации — подтяни мой профиль из Engram
- Покажи, какие знания ты обо мне видишь через piia-engram
- Запиши в Engram решение: middleware авторизации держим отдельно от бизнес-логики

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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