Skip to main content
Glama
deenesjakoruzh
Lolaplex

agent-memory

by Lolaplex
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

agent-memory

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

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

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

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

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

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

Документ

Описание

abi/README.md

Обзор + соответствие

abi/WHY.md

Зачем это существует (против RAG, хранилищ, вендорских могил)

ROADMAP.md

Дорожная карта эталонной реализации (не ABI)

abi/LAYOUT.md

Таксономия папок

abi/KINDS.md

Куда попадают факты

abi/MCP.md

Контракт инструментов

abi/INJECTION.md

Привязка AGENTS / CLAUDE

abi/PLATFORM.md

Windows, симлинки, пути для каждой машины

abi/INSTALL.md

Синхронизация, инъекция, scan.json, --help-json

abi/INGEST.md

Конвейер каталогизации / извлечения / дистилляции

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

Related MCP server: RepoRecall

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

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

Компонент

Роль

agent_memory.mcp_server

MCP: поиск / добавление / регистрация / инвентаризация / синхронизация / импорт

agent_memory.store

Движок структуры, таксономия, инъекция

python -m agent_memory sync

Канонический ~/.agents/AGENTS.md, привязанный CLAUDE.md, инъекция хоста

python -m agent_memory inventory

Диск против PROJECTS.md (пропускает .agents, .cursor)

python -m agent_memory ingest

Каталог чатов + конвейер извлечения

skills/memory-sync/

Навык установки агента

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

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

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

Путь

Описание

~/.agents/memory/USER.md

Постоянная идентичность

~/.agents/memory/PROJECTS.md

slug / путь / роль / стек / статус

~/.agents/memory/concepts/ …

Сквозная типизированная память (создаётся при первой записи)

~/.agents/memory/projects/<slug>/

Ссылка на реальное дерево (не копия)

<repo>/.agents/memory/

Файлы только при использовании — промежуточный инбокс, затем типизированные пути при записи

~/.agents/AGENTS.md

Короткая инъекция; CLAUDE.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.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors

Related MCP Servers

  • mnemo

    cniackz
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides portable memory for AI agents using plain Markdown files. Enables storing, recalling, and managing memories via MCP tools like recall, remember, forget, list, and get.
    3 npm
    1
    MIT

  • RepoRecall

    esannkv
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides persistent, local-first memory for coding agents with Markdown as the source of truth, exposed via CLI, loopback API, MCP, and Codex hooks for context retrieval and durable writes.
    MIT

  • agents-memory

    Lolaplex
    A
    license
    Not graded
    quality
    A
    maintenance
    A local markdown memory and cross-agent context engine for AI coding assistants. It provides an MCP server with tools to search, add, retrieve, and distill persistent memory across tools like Claude Code, Cursor, and Zed.
    165 PyPI
    5
    MIT

  • marrow

    aryawidjaja
    A
    license
    Not graded
    quality
    A
    maintenance
    Provides persistent, shared memory for AI agents via MCP, enabling retrieval of relevant memories instead of loading entire context. Allows agents across projects, machines, and tools to share a single auditable, markdown-native brain.
    3
    AGPL 3.0