agents-memory

Локальный движок памяти в формате Markdown и кросс-агентного контекста для ИИ-ассистентов программирования.
Одна постоянная идентичность, общая для Claude Code, Cursor, Antigravity и Zed.

Почему .agents/memory?

Название agents-memory происходит напрямую от его универсального стандарта хранения: .agents/memory.

• Глобальный: ~/.agents/memory/ хранит вашу постоянную идентичность, стек по умолчанию, долговременные концепции и индекс проектов.

• Репозиторий: <repo>/.agents/memory/ хранит специфичные для репозитория факты, ADR по архитектуре и промежуточные почтовые ящики.

Пока поставщики ИИ фрагментируют свои конфигурации по проприетарным хранилищам, .agents/ предоставляет единый открытый, вендорно-нейтральный файловый концентратор для всех конфигураций агентов и общей интеллектуальной информации.

agents-memory реализует это с помощью чисто Markdown-ориентированной архитектуры:

• Локально и офлайн: Ваша идентичность и память репозитория хранятся в обычных файлах (~/.agents/memory/ и <repo>/.agents/memory/).

• Читаемо для человека и дружелюбно к git: Редактируйте любым текстовым редактором, сравнивайте с git, фиксируйте когда захотите.

• Универсальный MCP-сервер: Предоставляет инструменты памяти (search_memory, add_memory, get_project_memories, distill_batch) всем современным агентам.

• Автономная инжестия и дистилляция: Извлекает долговременные правила и архитектурные решения из журналов сессий (OpenAI, Claude, Cursor, Copilot, Antigravity, Pi).

Related MCP server: agent-julia

Архитектура и потоки данных

 ┌─────────────────────────────────────────────────────────────┐
 │                       SESSION INGEST                        │
 │  OpenAI Exports · Claude JSONL · Cursor · Antigravity · Pi  │
 └──────────────────────────────┬──────────────────────────────┘
                                │  ingest catalog / extract
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                       STAGING INBOX                         │
 │        Raw captured bullets & noise-filtered facts          │
 └──────────────────────────────┬──────────────────────────────┘
                                │  distill_batch / skill
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                     LOCAL MEMORY STORE                      │
 │   ~/.agents/memory/USER.md     ~/.agents/memory/PROJECTS.md │
 │   ~/.agents/memory/concepts/   <repo>/.agents/memory/       │
 └──────────────┬───────────────────────────────┬──────────────┘
                │                               │
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │       IDE INJECTION         │ │     MCP SERVER & CLERK      │
 │  Cursor Rules · Zed Context │ │  search_memory · add_memory │
 │  Antigravity AGENTS.md      │ │  Universal Tool Integration │
 └─────────────────────────────┘ └─────────────────────────────┘

Быстрый старт

Установка за 1 шаг

pip install agents-memory && agents-memory sync --init

Создаёт структуру ~/.agents/memory/, автоматически подключает MCP-конфигурации в ваши установленные IDE и регистрирует навыки ассистента.

[!TIP] 🤖 Автоматическая установка агентом (без усилий):
Просто скажите вашему кодинг-агенту: «Установи и настрой agents-memory за меня».
Агент установит пакет, один раз спросит ваши предпочтения по стеку, заполнит ваш профиль USER.md и зарегистрирует ваши репозитории автоматически.

Справочник CLI

Поддерживаемая экосистема

• Claude Code: Привязка через символическую ссылку / канонический AGENTS.md и MCP-сервер.

• Google Antigravity: Интеграция через правила .gemini/config и MCP-сервер agents-memory.

• Cursor: Автоматически внедряет правила и настраивает .cursor/mcp.json.

• Zed: Настраивает context_servers и зеркалирует навыки ассистента.

• VS Code / Copilot: Загружает историю сессий из локальных баз данных состояния.

Также совместим с: Windsurf, Cline, Roo-Code, Continue.dev, Aider, Continue.dev, OpenAI ChatGPT, Pi и любым MCP-совместимым ИИ-ассистентом.

Открытая спецификация ABI

Формальная, не зависящая от реализации спецификация макета находится в abi/:

• abi/WHY.md — Архитектурные решения и почему Markdown побеждает RAG.

• abi/LAYOUT.md — Структура каталогов и их назначение.

• abi/KINDS.md — Типология памяти (concepts, facts, architecture).

• abi/MCP.md — Спецификации инструментов и запросов/ответов.

• abi/INJECTION.md — Механизмы внедрения правил в хосты.

Тестирование и проверка

python tests/run_all_tests.py