thread-keeper — MCP-сервер для Claude Code: общая память агентов
Один локальный MCP-сервер, который даёт разным агентским CLI общую память, координацию между сессиями и растущую библиотеку скиллов.
claude mcp add thread-keeper -- uvx threadkeeperЧто делает thread-keeper
Все подключённые клиенты работают с одной базой SQLite: общие треды, заметки, цитаты и модель пользователя. Агент записывает — любой другой читает, даже после смены CLI или перезапуска. В начале сессии сервер подсовывает сжатый бриф примерно на 6 KB с тегами и идентификаторами. Формат рассчитан на агента, человеку его читать неудобно.
Для параллельной работы есть примитивы spawn и broadcast/whisper/inbox/wait: дочерние агенты получают собственный self_cid и видят ту же память, а сессии могут перекликаться между разными CLI. Скиллы сервер пишет в SKILL.md и раскладывает копии по известным каталогам — ~/.claude/skills/, ~/.codex/skills/, ~/.gemini/config/skills/ и другим, включая пути из THREADKEEPER_EXTRA_SKILLS_DIRS. Где нативного загрузчика скиллов нет, остаётся lessons.md.
Нужен Python 3.11+ и uvx. Быстрый путь — pipx install 'threadkeeper[semantic]', затем thread-keeper-setup: он находит установленные CLI, прописывает MCP-сервер в конфиги, копирует хуки в ~/.threadkeeper/hooks/ и добавляет управляемый блок инструкций в CLAUDE.md, AGENTS.md или copilot-instructions.md. Сервер по умолчанию раз в сутки проверяет обновления: git-checkout с локальными правками он пропускает, а не перезаписывает, потому что чужие изменения важнее свежей версии.
Какие задачи решает
- передать контекст из сессии Claude в Codex без ручного копирования
- не дать двум параллельным агентам делать одну и ту же работу
- сохранить заметки и цитаты после закрытия треда
- собрать скиллы из нескольких CLI в одном каталоге
- поднять бриф о проекте при старте новой сессии
Примеры запросов агенту
- Открой тред по задаче с авторизацией и запиши туда всё, что выяснил
- Запусти двух дочерних агентов через
spawn: один чинит тесты, второй правит документацию - Прочитай входящие сообщения через
inbox— вторая сессия что-то мне отправила
Как установить thread-keeper
Командой платформы
claude mcp add thread-keeper -- uvx threadkeeperuvx запускает команду с именем пакета; если в README она другая — uvx --from threadkeeper <команда>
Командой платформы
codex mcp add thread-keeper -- uvx threadkeeperuvx запускает команду с именем пакета; если в README она другая — uvx --from threadkeeper <команда>
Файл настроек
{
"mcpServers": {
"thread-keeper": {
"command": "uvx",
"args": [
"threadkeeper"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from threadkeeper <команда>
Файл настроек
{
"servers": {
"thread-keeper": {
"type": "stdio",
"command": "uvx",
"args": [
"threadkeeper"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from threadkeeper <команда>
Командой платформы
gemini mcp add thread-keeper uvx threadkeeperuvx запускает команду с именем пакета; если в README она другая — uvx --from threadkeeper <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о thread-keeper
Как установить thread-keeper в Claude Code?
Выполните claude mcp add thread-keeper -- uvx threadkeeper и перезапустите CLI.
Что делает thread-keeper?
Держит общую память и координацию для нескольких агентских CLI поверх одной базы SQLite и пополняет библиотеку скиллов по ходу работы.
Что нужно, чтобы сервер заработал?
Python 3.11+ и запуск через uvx. Полная установка с хуками и инструкциями делается командой thread-keeper-setup после pipx install 'threadkeeper[semantic]'.
