octopus-blackboard — MCP-сервер для Claude Code: общая память агентов
Локальная доска, через которую несколько ИИ-агентов на одном репозитории видят задачи, правки и решения друг друга. Не оркестратор: только читает и записывает.
claude mcp add --env OCTOBOARD_AGENT=<OCTOBOARD_AGENT> --env OCTOBOARD_DIR=<OCTOBOARD_DIR> --transport stdio octopus-blackboard -- npx -y octopus-blackboardЧто делает octopus-blackboard
Claude, Codex, Cursor и остальные агенты работают в одном репозитории и не знают друг о друге. Один правит авторизацию, второй переписывает тот же файл. Blackboard даёт им общую доску: кто чем занят, что изменилось, какие решения приняты, какие риски открыты, что оставлено кому. Контракт простой — читать доску, писать в доску, оставлять сообщения и прикладывать доказательства.
Каждая запись ложится в append-only timeline с хеш-цепочкой. История проверяется командой octoboard verify, и правка задним числом ломает верификацию. Доска не блокирует работу: если два агента заявили одну задачу, оба claim записываются, а второй агент получает предупреждение о конфликте. Доска — один файл SQLite в .octoboard/, находится поиском вверх по дереву каталогов, как .git.
Сборка требует Node ≥ 22. Для запуска примера examples/two-agents.sh нужен octoboard в PATH — без него сценарий не отработает. Идентичность задаётся через --as <agent> или переменную OCTOBOARD_AGENT, конкретная доска — через --board <dir> или OCTOBOARD_DIR.
Быстрый старт: npx octopus-blackboard quickstart создаёт доску, определяет ваш MCP-клиент и печатает готовый блок конфигурации. Повторный запуск не затирает существующую доску и её историю.
Какие задачи решает
- увидеть, кто из агентов уже взял задачу, до начала работы
- поймать коллизию, когда два агента правят один файл
- зафиксировать решение вместе с причиной, по которой оно принято
- оставить хендофф другому агенту с контекстом по задаче
- проверить, что историю доски не подменили задним числом
Примеры запросов агенту
- Вызови
board_statusи скажи, кто сейчас на доске - Запиши в доску: Codex рефакторит middleware авторизации
- Заявори задачу
trust-layer-policy-schemaи предупреди, если её уже держит другой агент
Как установить octopus-blackboard
Командой платформы
claude mcp add --env OCTOBOARD_AGENT=<OCTOBOARD_AGENT> --env OCTOBOARD_DIR=<OCTOBOARD_DIR> --transport stdio octopus-blackboard -- npx -y octopus-blackboardВместо <…> подставьте свои значения
Командой платформы
codex mcp add octopus-blackboard --env OCTOBOARD_AGENT=<OCTOBOARD_AGENT> --env OCTOBOARD_DIR=<OCTOBOARD_DIR> -- npx -y octopus-blackboardВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"octopus-blackboard": {
"command": "npx",
"args": [
"-y",
"octopus-blackboard"
],
"env": {
"OCTOBOARD_AGENT": "<OCTOBOARD_AGENT>",
"OCTOBOARD_DIR": "<OCTOBOARD_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"octopus-blackboard": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"octopus-blackboard"
],
"env": {
"OCTOBOARD_AGENT": "<OCTOBOARD_AGENT>",
"OCTOBOARD_DIR": "<OCTOBOARD_DIR>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OCTOBOARD_AGENT=<OCTOBOARD_AGENT> -e OCTOBOARD_DIR=<OCTOBOARD_DIR> octopus-blackboard npx -y octopus-blackboardВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о octopus-blackboard
Как установить octopus-blackboard в Claude Code?
Выполните claude mcp add octopus-blackboard -- npx -y octopus-blackboard. Если нужны переменные окружения, есть вариант с флагами: `claude mcp add --env OCTOBOARD_AGENT=<OCTOBOARD_AGENT> --env OCTOBOARD_DIR=<OCTOBOARD_DIR> --transport stdio octopus-blackboard -- npx -y octopus-blackboard`.
Что делает octopus-blackboard?
Это пассивная локальная память для нескольких ИИ-агентов на одном репозитории. Она отвечает на шесть вопросов: кто чем занят, что изменилось, какие решения приняты, какие есть доказательства, какие риски открыты и что оставлено кому.
Чем octopus-blackboard отличается от оркестратора агентов?
Он никого не запускает и не планирует за агентов. Доска только записывает и показывает: конфликты она выявляет, но не блокирует — оба claim остаются в истории, а второй агент получает предупреждение.
