Foremerge — MCP-сервер для Claude Code: координация параллельных
Foremerge даёт параллельным агентам общий список намерений, чтобы конфликт планов всплыл до того, как оба начнут писать код.
Открыть на GitHubЧто делает Foremerge
Foremerge — протокол координации кодинг-агентов поверх Git. Каждый агент работает в своей изолированной рабочей копии, но перед правкой объявляет, что собирается менять: например, функцию sendEmail. Все объявления лежат в небольшой базе внутри папки .git, поэтому Claude, Codex и Cursor на одной машине видят одну картину.
Если два плана сталкиваются, Foremerge называет обоих агентов, объясняет причину и предлагает, как развести работу. Пример из описания: один агент заменяет PaymentService на StripePaymentService, другой дописывает PayPal в старый PaymentService. По строкам правки не пересекаются, Git пропустит обе, а работа по PayPal останется висеть на классе, который больше никто не вызывает. Foremerge сравнивает объявленные области видимости и операции (replace против extend) и выдаёт предупреждение уровня HIGH ещё до записи кода.
Файлы Foremerge не блокирует и агентов не останавливает: предупреждения носят рекомендательный характер, решение остаётся за вами. Конфликты разбирает детерминированный детектор, а не модель, поэтому одинаковый вход даёт одинаковый ответ. Для установки вручную нужны свежий Git и jq; бинарник ставится скриптом в ~/.local/bin либо из npm на macOS и Linux с glibc. Сборка из исходников требует Rust 1.85+. Связь между разными машинами в проект не входит.
Какие задачи решает
- поймать конфликт намерений двух агентов до того, как оба закоммитят
- развести параллельные задачи по разным рабочим копиям без ручной сверки
- увидеть, кто из агентов что собирается трогать прямо сейчас
- зафиксировать проверку, которой должен пройти результат агента
- объяснить команде, почему две правки в разных файлах ломают друг друга
Примеры запросов агенту
- Настрой Foremerge в этом репозитории, чтобы мы могли координировать параллельных агентов.
- Опубликуй своё намерение по
sendEmailи проверь конфликты перед правкой. - Зарегистрируй проверку
testкомандойforemerge checks set test -- cargo test --all-targets.
Как установить Foremerge
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Foremerge
Как установить Foremerge в Claude Code?
Проще всего отдать установку агенту: вставьте в Claude из корня репозитория инструкцию из быстрого старта — она ставит Foremerge через curl -fsSL https://foremerge.com/install.sh | sh, затем выполняет foremerge init, foremerge setup all, регистрирует проверку через foremerge checks set и подтверждает командой foremerge doctor --client all. Шаг 3 включает MCP-сервер, поэтому клиент спросит подтверждение.
Что делает Foremerge?
Собирает объявления агентов о том, что они собираются менять, в общий список внутри .git и сравнивает их между собой. При столкновении планов выдаёт предупреждение с именами агентов и причиной.
Foremerge блокирует файлы или останавливает агентов?
Нет. Предупреждения рекомендательные, файлы не блокируются, и решение остаётся за вами. Конфликты разбирает детерминированный детектор, а не модель.
