The Agent Guild MCP
Guild хранит задачи, знания и записки между сессиями в локальной SQLite, чтобы Claude Code, Codex и Cursor делили контекст
- 302 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Хуки дописываются в настройки Claude Code и Codex и подмешивают записи архива в промпты
- Агенты пишут и читают общую базу знаний, а ошибочная запись может повлиять на следующие сессии
Установка
- Работает в
Ручная установка
brew install mathomhaus/tap/guildСборка с семантическим поиском для macOS и Linux.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки дописываются в настройки Claude Code и Codex и подмешивают записи архива в промпты
- Агенты пишут и читают общую базу знаний, а ошибочная запись может повлиять на следующие сессии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Guild — один бинарный файл на Go со встроенным MCP-сервером и локальной базой SQLite. Он решает проблему забывчивости агентов: после сжатия контекста или новой сессии они теряют сделанное. В Guild четыре понятия. Quest — задача на доске с приоритетом и зависимостями. Lore — запись в архиве знаний, например решение или итог исследования. Oath — принципы проекта, которые загружаются в начале каждой сессии. Brief — записка для следующего агента. В начале сессии агент делает один вызов guild_session_start и получает принципы, последнюю записку и главную задачу. Дальше он берет задачу, ищет в архиве командой `guild lore appraise`, записывает находки и в конце оставляет записку. Закрытая задача открывает те, что ждали ее выполнения. Поиск сочетает BM25 и векторное сходство. Состояние общее для всех клиентов на машине, поэтому смена клиента не требует переноса. Команда `guild hooks install` подключает хуки Claude Code и Codex, и те сами подгружают нужные записи.
Для кого. Для разработчиков, которые ведут один проект сразу в нескольких агентах и хотят, чтобы задачи, решения и выводы переживали сессии и смену редактора.
Подходит, если
- Несколько агентов в разных редакторах работают над одним репозиторием, и им нужна общая доска задач с блокировкой, чтобы не брать одну и ту же
- После сжатия контекста Claude Code забывает принятые решения, а записка и архив должны вернуть их в начале следующей сессии
- В проекте копится исследование, и перед новым поиском агент должен проверять архив командой `guild lore appraise`
- Нужно связать задачи зависимостями, чтобы закрытие одной автоматически открывало следующие
- Хочется, чтобы принципы проекта загружались в каждую сессию без ручной вставки в промпт
Не подходит, если
- Вы работаете одним агентом над короткой задачей: накладные расходы на доску и архив не окупятся
- Нужна синхронизация между машинами или командой: состояние хранится только локально
- Вы хотите постоянное семантическое понимание кода: Guild хранит заметки агентов и не индексирует исходники
Пример запроса к агенту
Начни сессию guild для проекта myapp, возьми задачу с наивысшим приоритетом и перед работой проверь архив на похожие находкиMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- В готовых сборках для macOS и Linux есть семантический поиск, а в сборке для Windows и при установке через `go install` работает только поиск по ключевым словам BM25.
- Опциональный бэкенд Ollama отправляет текст на заданный адрес Ollama. По умолчанию эмбеддинги считает ваша машина.
- Хуки есть для Claude Code и Codex CLI. У Codex нет жизненного цикла сжатия контекста, поэтому запись перед сжатием Guild для него пропускает.
- Векторный поиск включается, когда эмбеддинги есть не менее чем у 90 процентов записей. До этого работает поиск по ключевым словам.
Как отключить. Выполните `guild hooks list` и уберите хуки, затем удалите запись guild из MCP-конфигурации клиента и блок в AGENTS.md. Данные лежат в ~/.guild, и вы можете удалить папку вместе с бинарным файлом.
Частые вопросы
Как установить Guild и подключить его к Claude Code?
Поставьте бинарный файл через `brew install mathomhaus/tap/guild` или скрипт `install.sh` из релиза. Затем в папке проекта выполните `guild init`: он зарегистрирует проект, добавит блок в AGENTS.md и предложит подключить Guild к найденным MCP-клиентам. После этого попросите агента начать сессию guild.
Чем отличаются quest_journal, lore_inscribe и quest_brief?
Журнал задачи живет до ее закрытия и нужен самому исполнителю. Запись в архив нужна другому агенту на другой задаче и сохраняется надолго. Записка закрепляет итог для следующей сессии и загружается вместе с принципами.
Как два агента не возьмут одну задачу?
Задачу захватывают атомарно командой `guild quest accept QUEST-42 --owner agent-a`. Пока она занята, другой агент берет следующую из доступных.
Что делают хуки Guild и как их подключить?
Команда `guild hooks install` прописывает в Claude Code SessionStart, PreCompact и UserPromptSubmit, а в Codex хуки старта и запроса. Они подгружают записку на старте, сохраняют контекст перед сжатием и подмешивают нужные записи при вводе промпта. `guild hooks diff` показывает, что изменит синхронизация.
Где хранятся данные Guild и как запустить его в Docker?
Данные лежат в SQLite в каталоге ~/.guild. В контейнере каталог /home/guild/.guild нужно смонтировать как именованный том, иначе состояние исчезнет вместе с контейнером: `docker run --rm -v guild-state:/home/guild/.guild guild:latest --version`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСлой памяти и координации для кодовых агентов: спецификации и задачи лежат в git, а агенты работают параллельно
Скилл для обмена сообщениями между Claude Code, Codex, Gemini CLI и другими консольными агентами через общую локальную базу SQLite на bash
Память для агентов на графе знаний: плагины для Claude Code и Codex, MCP-сервер и Python-библиотека
Локальная память для ИИ-агентов программиста: хуки записывают ход каждой сессии, и Claude Code, Codex или Cursor находят прошлые решения через MCP
Долговременная память для агентов: собирает знания из истории сессий и возвращает их в новых задачах, единый стор между Claude Code, Codex, Cursor и другими
Общая локальная память для Codex, Claude Code, Cursor, Hermes Agent и OpenClaw: агенты передают задачи, проверяют друг друга и ночью дорабатывают скиллы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| The Agent Guild (эта запись) | нет | не нужна | 302 | |
| projectmem | да | не нужна | 870 | локальная память кодинг-агентов о проблемах, попытках и фиксах; Guild добавляет доску задач с атомарным захватом и записки между сессиями |
| agent-memory | нет | 4 374 | долговременная память в файлах Markdown с индексом SQLite; Guild хранит принципы, архив и задачи в единой базе |
Коротко о README
Автор объясняет общую память агентов через образ гильдии и ведет читателя от установки до первой сессии. Рабочая сессия разбита на три акта, а отдельный режим отдает агентам ответы в JSON.