Basic Memory
Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом
Установка
claude mcp add basic-memory -- uvx --prerelease=allow basic-memory mcpЭто чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Basic Memory хранит знания в обычных Markdown-файлах, которые читают и пишут и человек, и агент. Каждая заметка содержит наблюдения по категориям и связи через вики-ссылки, из них строится граф, по которому агент восстанавливает контекст в новой сессии. Сервер дает инструменты для записи, чтения, правки и поиска заметок, навигации по графу, управления проектами и проверки структуры базы. Поиск бывает полнотекстовым, векторным и гибридным, индекс лежит в локальной SQLite. Есть плагин для Claude Code с брифингом в начале сессии и сохранением перед сжатием контекста.
Для кого. Для тех, кто ведет долгие проекты с агентом и не хочет каждый раз заново объяснять контекст.
Подходит, если
- Нужно, чтобы агент помнил решения и выводы между сессиями
- Нужна база знаний, которую можно открыть в Obsidian или редакторе
- Нужно работать с одними заметками из Claude, Codex и Cursor
Не подходит, если
- Хватает встроенных файлов памяти агента вроде CLAUDE.md
- Лицензия AGPL не подходит для вашего сценария распространения
Пример запроса к агенту
Запиши заметку о наших архитектурных решениях и свяжи ее с заметкой про авторизациюОграничения
Локальная версия бесплатна, нужен Python через uv и флаг --prerelease=allow в командах установки. Облачная версия платная и может быть недоступна из России. CLI отправляет минимальную анонимную телеметрию, отключается переменной BASIC_MEMORY_NO_PROMOS. Лицензия AGPL-3.0.
Как отключить. Выполните claude mcp remove basic-memory или удалите блок из конфигурации MCP. Заметки остаются в папке ~/basic-memory.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| BASIC_MEMORY_NO_PROMOS | Отключает промо облака и телеметрию |
| BASIC_MEMORY_SEMANTIC_SEARCH_ENABLED | Включает семантический поиск |
| BASIC_MEMORY_LOG_LEVEL | Уровень логирования |
Проверка безопасности
- Создает, меняет и удаляет файлы заметок на диске
- CLI сам обновляется в фоне при установке через uv tool или Homebrew
Коротко о README
README сравнивает облачный и локальный варианты и дает конфигурации для Claude Desktop, Claude Code, Codex, Cursor и VS Code. Описаны плагин Claude Code, общие скиллы, интеграции с Hermes и OpenClaw. Подробно разобран формат заметок: frontmatter, наблюдения и связи. Перечислены MCP-инструменты, команды CLI, переранжирование поиска, автообновления, телеметрия и логирование. Лицензия AGPL-3.0.
Частые вопросы
Обязательно ли облако?
Нет, локальная версия работает полностью на диске, облако нужно только для синхронизации между устройствами.
Зачем флаг --prerelease=allow?
Текущая версия зависит от предрелиза FastMCP, без флага uv поставит старый выпуск.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Агент Anthropic для терминала, IDE и GitHub: понимает кодовую базу, выполняет задачи и работает с git
Агент OpenAI для программирования, который работает локально в терминале, с версиями для IDE и десктопа