LoreConvo v0.10.6

Ваша память следует за вашей личностью, а не за вашим инструментом — с вашего согласия.

LoreConvo — это единственная AI-память, которая переносит ваш контекст между Claude Code, Cowork, Codex, Cursor и Hermes Agent. Одна установка, одна память, где бы вы ни писали код.

Установка прямо из маркетплейса плагинов Claude Code или через PyPI: uvx loreconvo

Почему LoreConvo?

Работает там, где работаете вы

LoreConvo работает в Claude Code, Cowork, Cursor, Codex и Hermes — один и тот же слой памяти, независимо от того, какой клиент вы используете. Когда вы переключаетесь между проектами, ваш контекст автоматически путешествует вместе с вами.

Большинство инструментов ограничивают память машиной или рабочим пространством. LoreConvo хранит всё локально в базе данных SQLite, которая принадлежит вам, и отображает её где бы вы ни находились. Захват происходит двумя способами: явно через инструменты сохранения или автоматически в конце сеанса, если вы установите дополнительные хуки. В любом случае вы можете просмотреть, отредактировать или удалить любую память в любое время.

Вы контролируете, что сохраняется

LoreConvo даёт вам контроль: автоматический захват работает только если вы решите установить хуки сеанса, каждое сохранение можно проверить, и вы можете удалить любую память в любое время.

Каждая память показывает, откуда она взялась — какая поверхность её захватила, когда, к какому проекту она относится, и какой навык её создал. Никакой тайны. Полная прослеживаемость.

Ваша память остаётся на вашей машине

LoreConvo хранит всё в базе данных SQLite на вашей собственной машине. Ваши данные остаются локальными, если вы явно не включите дополнительную функцию AI-суммаризации (Pro, по умолчанию выключена), которая отправляет фрагмент транскрипта в Anthropic API с использованием вашего собственного ключа. Никаких облачных аккаунтов. Никакого поставщика с доступом к вашей истории сеансов.

Ваши сеансы хранятся в ~/.loreconvo/sessions.db — файле, которым вы владеете, можете создавать резервные копии и удалять когда захотите.

Структурированная память, а не сырые транскрипты

LoreConvo захватывает два типа памяти для каждого сеанса:

• Эпизодическая память: что произошло — сводки, созданные артефакты, оставшиеся открытые вопросы

• Семантическая память: что было решено — устойчивые выводы о проекте, которые сохраняются между сеансами

Вместе они дают Claude структурированную, доступную для поиска запись истории вашего проекта, а не просто кучу транскриптов чата.

Related MCP server: ai-memory

Бенчмарк Recall

Поиск FTS5 в LoreConvo протестирован на синтетическом корпусе из 60 сеансов (6 тематических областей, 36 размеченных запросов).

Расширение составных токенов (предобработка запросов camelCase / snake_case) повышает Recall@5 на +35.7 п.п. для запросов, использующих технические идентификаторы, такие как autoSave, pipeline_tracker и get_context_for.

Полный отчёт о бенчмарке | Воспроизвести

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

Одна команда для установки:

bash install.sh

Это создаёт виртуальное окружение, устанавливает зависимости и проверяет, что всё работает. Никаких изменений в системном Python, никаких ручных команд pip.

Использование LoreConvo

Claude Code (Терминал)

Начать сеанс с загруженным плагином:

claude --plugin-dir /path/to/loreconvo

Или загрузить его внутри существующего сеанса:

/plugin add /path/to/loreconvo

Замените /path/to/loreconvo на путь, куда вы сохранили папку с исходниками.

После внесения изменений в код используйте /reload-plugins, чтобы обновить без перезапуска.

После загрузки Claude автоматически получает доступ ко всем 39 инструментам MCP LoreConvo. Попросите Claude «сохранить этот сеанс» или «вспомнить, что мы обсуждали о X», и он сам воспользуется инструментами.

Cowork (Настольное приложение)

1. Нажмите кнопку + рядом с полем ввода

2. Выберите Плагины

3. Выберите Добавить плагин

4. Перейдите к папке исходников loreconvo

Важно: Общий доступ к базе данных

Cowork работает в изолированной виртуальной машине и по умолчанию не видит файловую систему вашего Mac. Чтобы прочитать сеансы, сохранённые Claude Code, попросите Claude в Cowork:

«Подключи мою папку ~/.loreconvo»

После подключения Cowork читает и записывает в ту же базу данных, что и Claude Code. Сеансы, сохранённые в Code, мгновенно появляются в Cowork.

Claude Chat (Веб)

Chat не поддерживает плагины, поэтому LoreConvo предоставляет мост в одну команду. Запустите это в терминале:

bash export-to-chat.sh

Это экспортирует ваш последний сеанс и копирует его в буфер обмена (macOS). Переключитесь на Chat и вставьте (Cmd+V). Chat мгновенно получает контекст из вашего сеанса Code или Cowork.

Чтобы найти конкретный сеанс:

bash export-to-chat.sh "tax prep"

Как это работает на разных поверхностях

Основная ценность LoreConvo в том, что контекст автоматически сохраняется между поверхностями Claude. Вот полная цепочка:

Claude Code  (~/.claude/settings.json via `claude mcp add`)
  |-- SessionEnd hook --> auto_save.py --> ~/.loreconvo/sessions.db
  |-- SessionStart hook <-- auto_load.py <-+
                                           |
Cursor       (.cursor/mcp.json) <--MCP-----+
Codex        (~/.codex/config.toml) <--MCP-+
Hermes Agent (~/.hermes/config.yaml) <-MCP-+
Cowork       (MCP-native execution env) <--+
  All surfaces: save_session / get_recent_sessions / search_sessions

Claude Chat (web)
  |-- export-to-chat.sh --> clipboard --> paste into Chat

Claude Code — основная поверхность. Хуки запускаются автоматически:

• Когда сеанс заканчивается, auto_save.py захватывает разговор и сохраняет структурированную сводку (решения, артефакты, открытые вопросы, теги) в локальную базу данных SQLite.

• Когда начинается новый сеанс, auto_load.py запрашивает базу данных, оценивает недавние сеансы по качеству сигнала и внедряет наиболее релевантный контекст в сеанс как системный контекст. Сеансы с открытыми вопросами и решениями получают наивысший балл; сеансы с низким сигналом отфильтровываются. Он также индексирует любой MEMORY.md, найденный в каталоге проекта (см. Автоиндексация MEMORY.md ниже).

Cursor подключается через .cursor/mcp.json в корне проекта — тот же протокол MCP, что и Claude Code. См. INSTALL.md для деталей настройки.

OpenAI Codex подключается через ~/.codex/config.toml с использованием секции [mcp_servers.<name>]. См. INSTALL.md для деталей настройки.

Hermes Agent подключается через ~/.hermes/config.yaml в разделе mcp_servers:. См. INSTALL.md для деталей настройки.

Claude Chat (веб) не поддерживает плагины. Скрипт export-to-chat.sh заполняет этот пробел: он экспортирует ваш последний сеанс в буфер обмена, чтобы вы могли вставить его прямо в Chat. Это даёт Chat тот же контекст, который Code загрузил бы автоматически.

Результат: когда вы переключаете поверхности в середине проекта, вам никогда не придётся заново объяснять, что вы делали.

Ваши данные всегда доступны

LoreConvo работает через инструменты MCP, когда они доступны, и автоматически переключается на встроенные скрипты, когда их нет. Ваши сеансы в безопасности независимо от статуса MCP — те же операции сохранения, поиска и извлечения работают в обоих случаях. Вам не нужно ничего настраивать; навык плагина обрабатывает переключение незаметно.

Проектные рабочие пространства

Проекты LoreConvo — это постоянные рабочие пространства — каждый сеанс, решение и артефакт из вашей работы над проектом доступны для поиска с любой поверхности Claude.

# Create a project workspace
create_project("my-api", "REST API project", expected_skills=["openapi", "python"])

# Add persistent project instructions (optional)
create_project(
    "my-api",
    description="REST API project",
    instructions="Python 3.10+, SQLite only. No cloud dependencies. Deploy via Docker."
)

# See recent sessions, skill usage, and open questions for the project
get_project("my-api")

# Search scoped to the project
search_sessions("auth design", project="my-api")

Инструкции проекта (необязательно): При создании проекта вы можете сохранить постоянные инструкции или ограничения, которые Claude увидит в начале сеанса. Это полезно для соблюдения стандартов проекта без повторения их в каждом файле CLAUDE.md. Инструкции отображаются в контексте автозагрузки перед сводками недавних сеансов.

В сочетании с LoreDocs LoreConvo образует переносимое проектное рабочее пространство для всего Claude — память сеансов И структурированные знания, полностью на вашей машине. Там, где облачные AI-рабочие пространства привязывают вас к одной экосистеме, пара Lore работает на всех поверхностях Claude, которые вы уже используете.

Автоиндексация MEMORY.md

Если в вашем проекте есть файл MEMORY.md, LoreConvo автоматически индексирует его при каждом запуске сеанса. Содержимое становится доступным для поиска вместе с обычными сеансами через search_sessions.

Это означает, что Claude может вспомнить соглашения проекта, заметки команды или архитектурные решения из MEMORY.md без необходимости упоминать их. Результаты поиска из MEMORY.md помечаются тегом memory_md и имеют source='file_memory', чтобы вы могли отличить их от обычных записей сеансов.

Какой каталог сканируется?

По умолчанию LoreConvo сканирует каталог, в котором запущен Claude Code (текущий рабочий каталог). Чтобы указать другой каталог, передайте LORECONVO_PROJECT_PATH как флаг окружения в вашей команде claude mcp add --scope user:

"--env=LORECONVO_PROJECT_PATH=/Users/YOUR_USERNAME/projects/my_project"

Замените YOUR_USERNAME и my_project на ваши реальные значения. Используйте полный абсолютный путь — не используйте ~ или $HOME.

Фильтрация записей MEMORY.md в результатах поиска

Чтобы включить записи MEMORY.md в поиск, используйте search_sessions обычным образом — они появляются автоматически. Чтобы видеть только записи MEMORY.md, отфильтруйте по тегу:

«Найди сеансы LoreConvo с тегом memory_md для „database conventions“».

Индекс обновляется при каждом запуске сеанса (идемпотентно — дубликаты не накапливаются).

Проверка установки

После установки проверьте, что LoreConvo работает, спросив Claude:

«Выполни get_recent_sessions и покажи мне результаты».

Если вы видите список сеансов (или пустой список, если это первый раз), LoreConvo подключён. Если вы получаете ошибку об отсутствующих инструментах, повторно запустите bash install.sh и перезагрузите плагин.

Для проверки хуков (только Claude Code):

«Проверь, загрузил ли LoreConvo какой-либо контекст автоматически в начале этого сеанса».

Если хук SessionStart работает, Claude автоматически получит контекст из ваших недавних сеансов.

Рекомендуемая настройка CLAUDE.md

Для лучшего опыта добавьте следующий фрагмент в ваш ~/.claude/CLAUDE.md (глобальный) или в CLAUDE.md вашего проекта. Это сообщает Claude, как использовать LoreConvo последовательно во всех сеансах.

## LoreConvo (persistent session memory)

At session start:
1. Call `get_recent_sessions` to check for recent context relevant to the current work.
2. Use this context to avoid re-explaining things already discussed in prior sessions.

During the session:
- If important decisions are made or domain knowledge is shared, note it for the session summary.

At session end:
- Call `save_session` with a summary of what was accomplished, key decisions, open questions,
  and any artifacts created. Use appropriate tags (e.g., project name, surface).

Для пользователей Cowork: Cowork не запускает хуки автоматически. Добавьте инструкции вызывать get_recent_sessions в начале сеанса и save_session в конце в ваш проектный CLAUDE.md. См. COWORK_RESTORE.md для деталей.

Планы: Free vs Pro

LoreConvo — локальный и бесплатный в использовании. Pro ($8/мес) снимает ограничение на количество сеансов и открывает сводки качества LLM, гибридный поиск и связывание между продуктами. Всё работает на вашей машине на любом плане — Pro не добавляет облачных компонентов.

Поиск в бесплатном тарифе: ключевые слова (FTS5) + сортировка по новизне. Поиск в тарифе Pro: гибридный поиск — векторный (BGE-small-en-v1.5), полнотекстовый BM25 и переранжирование по новизне, объединённые через RRF-фузию. Находит сеансы по смыслу, а не только по ключевым словам.

Проверьте свой текущий тариф и использование с помощью get_tier. Активируйте лицензию Pro с помощью vault_set_tier.

Возможности

• Автоматический захват сессий: Сессии сохраняются в конце сессии и загружаются в начале сессии через хуки Claude Code -- ручной вызов save_session не требуется

• Кросс-клиентская память: Ваш контекст следует за вами в Claude Code, Cowork, Cursor, Codex и Hermes -- не привязан к одной IDE или машине

• Структурированные сессии: Захватывает решения, артефакты, открытые вопросы -- не только сырой текст; необязательное поле reasoning_notes хранит цепочки рассуждений агента

• Организация проектов: Группировка сессий по проектам с ожидаемыми наборами навыков

• Отслеживание навыков: Запись использованных навыков для умной фильтрации

• Тегирование персон: Иерархические персоны для памяти, специфичной для агента (например, ron-bot:sql)

• Полнотекстовый поиск: SQLite FTS5 для быстрого поиска по ключевым словам во всех сессиях

• Автоиндексация MEMORY.md: Ваш проект MEMORY.md автоматически индексируется в начале сессии и доступен для поиска наряду с обычными сессиями через search_sessions

• Асинхронная суммаризация сессий через LLM (Pro): Автосохраненные сессии в фоновом режиме улучшаются до сводок уровня LLM с помощью Claude Haiku. Включите, установив LORECONVO_ANTHROPIC_API_KEY. Ежедневный лимит (LORECONVO_SUMMARIZER_DAILY_CAP, по умолчанию 100) предотвращает неконтролируемые расходы на API. Только для тарифа Pro.

• Поиск связанных сессий на основе эмбеддингов (Pro): get_related_sessions автоматически находит сессии с похожим содержимым, используя эмбеддинги BGE-small-en-v1.5 (косинус >= 0.75). До 10 двунаправленных автоматических связей при каждом сохранении, в пределах одного проекта. Бесплатный тариф получает связи по совпадению ключевых слов. Установите LORECONVO_EMBEDDING_LINKS=0, чтобы отключить связи на основе эмбеддингов.

• Межпродуктовое связывание документов (Pro): Автоматически находит и связывает документы LoreDocs, наиболее релевантные для любой сессии, и наоборот. Использует два новых инструмента: get_docs_for_session и session_link_doc. Требуются LoreConvo Pro и LoreDocs Pro.

• Локально-ориентированное: База данных SQLite, без зависимости от облака, нулевые затраты на API

Тарифы

Бесплатно - 50 сессий

• Полный набор функций: автозагрузка, полнотекстовый поиск, тегирование, связывание сессий, экспорт и импорт

• Локальное хранилище SQLite -- ваши данные, ваша машина, облачная учетная запись не требуется

• Установка в один клик через Anthropic Marketplace

Pro - $8/месяц

• Безлимитные сессии

• Командная память: делитесь сессиями с коллегами (локально-ориентированный асинхронный экспорт/импорт, сервер не требуется)

• Поиск связанных сессий и семантический поиск

• Экспорт для управляемых агентов Anthropic

• Фоновая суммаризация сессий уровня LLM (асинхронно)

Перейти на Pro -- $8/месяц

MCP-инструменты

LoreConvo предоставляет 39 MCP-инструментов, которые Claude вызывает автоматически во время сессий. В таблице ниже показаны наиболее часто используемые -- полный справочник см. в Каталоге MCP-инструментов.

Требования

• Python 3.10+

• macOS или Linux

• mcp и click (автоматически устанавливаются install.sh)

Данные и конфиденциальность

LoreConvo является локально-ориентированным. Все данные хранятся в ~/.loreconvo/sessions.db на вашей машине.

• Собираемые данные: Заголовки сессий, сводки, теги, идентификаторы поверхностей, названия проектов и имена навыков, которые вы указываете при сохранении. Никакая телеметрия, аналитика использования или идентификаторы не собираются автоматически.

• Хранение: База данных SQLite по пути ~/.loreconvo/sessions.db. Без облачного хранения. Переопределите путь с помощью переменной окружения LORECONVO_DB.

• Передача третьим лицам: По умолчанию никакой. Данные покидают вашу машину только если вы включите опциональную AI-суммаризацию (Pro), установив LORECONVO_ANTHROPIC_API_KEY, которая отправляет ограниченный фрагмент транскрипта в Anthropic API под вашим собственным ключом. Оставьте ключ неустановленным -- и все останется локальным.

• Срок хранения: Данные хранятся до тех пор, пока вы не удалите их через delete_session или не удалите файл базы данных вручную. Автоматического истечения срока нет.

• Контакт: info@labyrinthanalyticsconsulting.com

Полная политика конфиденциальности: https://labyrinthanalyticsconsulting.com/privacy

Устранение неполадок

Инструменты MCP не отображаются в Claude Code? Убедитесь, что вы сначала запустили bash install.sh. Папка .venv должна существовать с установленными зависимостями.

Ошибка "No module named 'mcp'"? Файл .mcp.json указывает на .venv/bin/python3 внутри папки плагина. Если вы переместили папку, повторно запустите bash install.sh.

Cowork не видит сессии, сохраненные в Code? Попросите Claude "смонтировать мою папку ~/.loreconvo", чтобы Cowork мог получить доступ к общей базе данных.

Резервный скрипт (прямой доступ к БД)

Если MCP-сервер недоступен (например, в запланированных задачах или скриптах автоматизации), scripts/save_to_loreconvo.py предоставляет те же основные операции напрямую с базой данных SQLite.

# Save a session
python scripts/save_to_loreconvo.py \
    --title "Daily QA run" \
    --surface "qa" \
    --summary "Ran full test suite. All passing." \
    --tags '["qa", "automated"]'

# Read recent sessions
python scripts/save_to_loreconvo.py --read --limit 5

# Filter by surface
python scripts/save_to_loreconvo.py --read --surface code --limit 3

# Search sessions
python scripts/save_to_loreconvo.py --search "tax pipeline"

Скрипт автоматически обнаруживает базу данных по пути ~/.loreconvo/sessions.db (или передайте --db-path явно). Он генерирует корректные UUID и записывает ту же схему, что и инструмент MCP save_session.

Что нового

v0.10.6 (2026-08-19)

Исправлено: оповещения о сбоях могли замолчать во время того самого сбоя, который они призваны обнаруживать

Если хук сохранения падал достаточно рано — ещё до завершения запуска, — сбой не регистрировался вовсе, и оповещение «автоматическое сохранение перестало работать» молчало в той самой ситуации, для которой оно и было создано. Теперь хуки сохранения фиксируют сбой через резервный путь, даже если падают так рано, поэтому оповещение срабатывает при любом сценарии сбоя, а не только при тех, где хук успевает зайти достаточно далеко, чтобы сообщить о себе.

Полную историю релизов см. в журнале изменений.

Лицензия

Business Source License 1.1 (BSL 1.1) - Labyrinth Analytics Consulting

Бесплатно для личного/некоммерческого использования (до 50 сессий). Коммерческое использование требует платной лицензии. Преобразуется в Apache 2.0, начиная с 2030-03-31. Подробности см. в LICENSE.