# agent-memory

Локальная память проекта для ИИ-агентов: решения, правила и факты хранятся в Markdown и проходят проверку через Git.

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

## Что делает

agent-memory сохраняет состояние задач, решения, соглашения, ошибки и факты по модулям в Markdown внутри Git-репозитория. Агент может записать изменение, подготовить его к проверке, показать точный diff и применить после подтверждения. Память учитывает ветки и проверяет записи на секреты и персональные данные.

Сервер работает локально, без cloud-хранилища и vector DB; Markdown остаётся источником правды. В проекте есть три MCP-инструмента и CLI, а изменения можно объединять при параллельной работе. Для подключения к Claude Code используется `npx -y @xchucx/agent-memory`, поэтому команду запуска нужно добавить через `claude mcp add`. Это значит, что содержимое памяти можно читать и просматривать через обычный Git diff.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## Примеры запросов агенту
- Сохрани решение о выборе библиотеки и подготовь его к проверке.
- Покажи diff накопленной памяти и примени его после моего подтверждения.
- Через `fetch` найди соглашения для этого модуля и учти их в текущей задаче.

## Похожие
- [Engram](https://affpapa.org/nevibecode/mcp/rwnalds-engram.md) — MCP-сервер · ★ 17
- [Cathedral — Persistent Memory for AI Agents](https://affpapa.org/nevibecode/mcp/cathedral-persistent-memory-for-ai-agents.md) — MCP-сервер · ★ 10
- [commit-context](https://affpapa.org/nevibecode/skills/commit-context.md) — скилл · 13700 установок
- [agent-knowledge](https://affpapa.org/nevibecode/mcp/agent-knowledge.md) — MCP-сервер · ★ 19
- [memory-management](https://affpapa.org/nevibecode/skills/aaron-he-zhu-memory-management.md) — скилл · 4900 установок
- [cursor-memory-curator](https://affpapa.org/nevibecode/skills/cursor-memory-curator.md) — скилл · 2700 установок

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