# KLYPIX Shared Project Memory

MCP-сервер хранит решения, исправления и заметки проекта в brain.klypix, чтобы разные сессии видели общий контекст.

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

## Что делает

KLYPIX сохраняет решения, исправления и открытые вопросы проекта в файле `brain.klypix`. Файл хранится вместе с кодом в Git, а люди могут править его вручную. Сервер также предупреждает о пересечении работы, когда несколько сессий планируют менять один файл.

Сессии могут оставлять друг другу заметки и передавать незавершённую работу. В Claude Code сервер добавляет хуки жизненного цикла и git-защиту для общего checkout: опасная команда сохраняет резервную копию и запрашивает подтверждение. В других хостах агент вызывает `brain_sync` и `brain_note` сам.

Для запуска нужен Node.js 20 или новее. Без него команда `npx klypix-mcp install` не выполнится, поэтому это требование нужно проверить заранее.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `KLYPIX_VAULT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env KLYPIX_VAULT=<KLYPIX_VAULT> --transport stdio klypix-shared-project-memory -- npx -y klypix-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add klypix-shared-project-memory --env KLYPIX_VAULT=<KLYPIX_VAULT> -- npx -y klypix-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "klypix-shared-project-memory": {
            "command": "npx",
            "args": [
                "-y",
                "klypix-mcp"
            ],
            "env": {
                "KLYPIX_VAULT": "<KLYPIX_VAULT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "klypix-shared-project-memory": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "klypix-mcp"
            ],
            "env": {
                "KLYPIX_VAULT": "<KLYPIX_VAULT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e KLYPIX_VAULT=<KLYPIX_VAULT> klypix-shared-project-memory npx -y klypix-mcp
```
Вместо <…> подставьте свои значения

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

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

## Похожие
- [memory-management](https://affpapa.org/nevibecode/skills/memory-management-2.md) — скилл · 1100 установок
- [Montycat MCP - Shared Memory for AI Agents](https://affpapa.org/nevibecode/mcp/montycat-mcp-shared-memory-for-ai-agents.md) — MCP-сервер · ★ 23
- [SPM - Structured Project Memory](https://affpapa.org/nevibecode/mcp/spm-structured-project-memory.md) — MCP-сервер
- [Listspace](https://affpapa.org/nevibecode/mcp/listspace.md) — MCP-сервер
- [project-session-manager](https://affpapa.org/nevibecode/skills/project-session-manager.md) — скилл · 872 установки
- [spark-recipe-shared-inbox-status](https://affpapa.org/nevibecode/skills/spark-recipe-shared-inbox-status.md) — скилл · 336 установок

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