agent-memory

Локальная markdown-память для кодинг-агентов — любой провайдер, любой инструмент.

Без общего формата каждый вендор владеет кладбищем — архивы сессий, которые никогда не становятся долговременной идентичностью, если вы не переучиваете каждого нового агента. См. abi/WHY.md для полного обоснования (против RAG, против хранилищ, против вендорской памяти). Дорожная карта эталонной реализации: ROADMAP.md.

Ваша память живёт в папках, которыми вы владеете: ~/.agents/memory (идентичность + карта проектов) и <repo>/.agents/memory (работа по проектам). Ваш агент — или любой хост, который читает markdown и опциональный MCP — использует ту же структуру.

Markdown — источник истины. Python MCP в этом репозитории — эталонная реализация, а не проприетарный бэкенд.

ABI (стабильный контракт)

Поставляется в abi/ — версионируемый, документированный, не зависящий от реализации:

Установка копирует abi/LAYOUT.md → ~/.agents/memory/LAYOUT.md. Инъекция и флаги CLI: abi/INSTALL.md. Машиночитаемо: python -m agent_memory --help-json.

Related MCP server: mcp-chest-memory

Эталонная реализация (этот репозиторий)

Python находится в src/agent_memory/ (pip install -e . из клона).

Шаблоны только в git: examples/*.example.*. Живое хранилище: ~/.agents/memory. Запустите python -m agent_memory consolidate, если markdown просочился в этот клон.

Кодинг-агенты: следуйте AGENTS.md для установки.

Структура (кратко)

Поиск объединяет пользователя + все зарегистрированные деревья проектов. Тела чатов остаются в папках продуктов; chats-index.md содержит только заголовки и пути.

Установка

Тот же интерпретатор для pip и MCP:

python -m pip install -e .
python -m agent_memory sync --init
python -m agent_memory inventory

Заполните ~/.agents/memory/USER.md и scan.json (из examples/*.example.* при первом запуске). Перезагрузите вашего агента после слияния MCP.

См. abi/PLATFORM.md о заглушках симлинков Windows и запасном варианте с жёсткими ссылками.

Скрипты

python -m agent_memory inventory
python -m agent_memory inventory --json
python -m agent_memory inventory --register SLUG "/path/to/repo" "role" "stack"
python -m agent_memory sync
python -m agent_memory --help-json
python -m agent_memory sync --help-json
python -m agent_memory inventory --help-json
python -m agent_memory ingest catalog

После установки agent-memory в PATH — то же самое, что python -m agent_memory.