Longhand
Longhand — MCP-сервер сообщества (автор — Wynelson94). Локальная память для Claude Code: 13 инструментов для семантического поиска, воспроизведения файлов и истории Git. Ставится через pip. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- Wynelson94
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- linux, macos, windows
- Языки
- python
Уровень риска: medium
Локальный архив сессий Claude Code и Codex в SQLite; Windows только через WSL2.
Настройка клиентов
{
"code": "codex mcp add longhand -- longhand shared-mcp",
"lang": "bash",
"verified": "docs"
}
Что умеет
Longhand — постоянная локальная память для Claude Code. Каждая сессия Claude Code пишет JSONL-файл в ~/.claude/projects/, где есть все сообщения, вызовы инструментов, блоки рассуждений и правки файлов с полным содержимым до и после. Longhand читает эти файлы и сохраняет события дословно в локальную базу SQLite. Claude Code через несколько недель удаляет старые файлы сессий, а в архиве Longhand история остаётся и после этого. Сводки моделью не составляются, вызовов API нет, всё хранится на вашей машине.
MCP-сервер даёт клиенту 13 инструментов:
- Архив:
search— семантический поиск с фильтрами по сессии, проекту, инструменту, файлу и типу события;list_sessions— недавние сессии;get_session_timeline— хронология сессии с постраничным выводом;replay_file— восстановление состояния файла на момент времени;get_file_history— все правки файла во всех сессиях;get_stats— статистика хранилища. - Проактивная память:
recall— нечёткие вопросы на естественном языке о прошлой работе (автор советует начинать с него);recall_project_status— «на чём мы остановились» по проекту с учётом git;find_episodes— пары «проблема → исправление»;list_projects— распознанные проекты;list_plans— все правки файлов планов в~/.claude/plans/. - Git:
find_commits— поиск коммитов по сообщению, хешу или ветке. - Самовосстановление:
reconcile— повторная привязка и загрузка сессий; по умолчанию пробный прогон, изменения — только сfix=true.
Кроме сервера, в пакете есть хуки Claude Code для автоматической загрузки новых сессий, необязательная подстановка прошлого контекста в новые запросы, резервное копирование архива и необязательная маскировка секретов при загрузке.
Кому подойдёт
Тем, кто много работает в Claude Code и хочет спрашивать агента о прошлых решениях и исправлениях: «что мы решили про middleware авторизации на прошлой неделе?». С версии 1.1.0 в тот же архив попадают треды Codex Desktop и Codex CLI. Другие серверы памяти — в категории знания и память.
Установка
Нужен Python 3.10–3.14. Windows не поддерживается — автор советует WSL2.
pip install longhand
longhand setuplonghand setup загружает существующую историю Claude Code, ставит хуки, регистрирует сервер в Claude Desktop и выводит команду для Claude Code. По словам автора, первый раз это занимает около двух минут. Регистрация в Claude Desktop (longhand mcp install) пишет только в путь конфигурации для macOS. Обновление: pip install -U longhand.
Подключение к клиентам
Команды из README. Подробнее — в инструкции как подключить MCP.
claude mcp add longhand -s user -- longhand mcp-serverДля Codex используется отдельный режим shared-mcp — поиск по ключевым словам в общем архиве Claude Code и Codex. Перед ним выполните longhand codex-sync, чтобы загрузить треды Codex. Для Codex Desktop README отсылает к документации по config.toml.
Проверка
После перезапуска клиента спросите агента о недавней сессии — он должен вызвать recall или list_sessions и вернуть данные из архива.
Примеры задач
Где мы остановились по проекту billing-service? Покажи последние коммиты и нерешённые проблемы.Как мы чинили гонку в очереди задач на прошлой неделе? Покажи исправление.Риски
- Чувствительные данные. В архиве дословно хранятся рассуждения, команды и содержимое файлов, включая случайно попавшие секреты. Маскировка секретов по умолчанию выключена: включите её через
longhand config --set redact.enabled=true. - Изменение настроек Claude Code.
longhand hook installдобавляет хуки в~/.claude/settings.json. - Изменение архива.
reconcileсfix=trueперезагружает данные в базу. - Единственная копия. Большая часть истории может существовать только в
~/.longhand/longhand.db— подумайте оlonghand backup.
Частые вопросы
Отправляются ли данные в облако?
Нет, по README всё хранится локально и вызовов API нет.
Работает ли на Windows?
Нет, только через WSL2.
Нужен ли ключ API?
Нет.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Memory
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.