Repolode
cj-vana

cj-vana/claude-swarm

MCP-сервер для координации параллельных групп Claude Code в tmux и git worktrees с поведенческими ограничениями на основе протоколов и веб-панелью в реальном времени.

Звёзды
117
Форки
10
Открытые issues
0
Последний коммит
8 месяцев назад

Что это?

Claude Swarm — это MCP-сервер, который позволяет сессии Claude Code координировать работу нескольких воркеров Claude Code. Каждый воркер запускается в отдельной сессии tmux в изолированном git worktree, реализует одну возможность и отправляет отчёты о статусе. Сервер сохраняет состояние сессий на диске, чтобы работа могла продолжаться после сжатия контекста, сбоев и перезапусков машины благодаря контрольным точкам и восстановлению по heartbeat.

Проект добавляет несколько механизмов для длительной автономной разработки. Перед реализацией воркеры могут пройти этап планирования только для чтения, для сложных возможностей можно подготовить конкурирующие планы, а Ralph Loop запускает новую сессию Claude на каждой итерации, сохраняя прогресс в файлах. Команды проверки должны завершиться успешно, прежде чем возможность будет отмечена как готовая; неудачные попытки можно автоматически повторять, а после завершения проводятся структурированные проверки кода и архитектуры.

Протоколы задают поведенческие ограничения, например ограничения на использование инструментов, правила доступа к файлам и лимиты ресурсов. Их проверяют перед запуском воркера и отслеживают во время его работы; нарушения записываются для последующего разбора. Веб-панель на localhost:3456 передаёт вывод терминалов воркеров и ход сессий через Server-Sent Events.

Ключевые возможности

  • 01Запускает параллельных воркеров Claude Code в сессиях tmux, каждый — в отдельном git worktree.
  • 02Сохраняет состояние сессий и контрольные точки, чтобы работа продолжалась после сбоев и перезапусков.
  • 03Использует для сложных возможностей двухэтапный цикл: планирование, затем реализация.
  • 04Требует успешного прохождения команд проверки перед отметкой возможности как готовой и поддерживает автоматические повторы.
  • 05Задаёт поведенческие протоколы, которые проверяются до запуска воркера и отслеживаются во время его работы.
  • 06Предоставляет веб-панель с выводом терминалов в реальном времени.

Сценарии использования

  • Разделение большого набора возможностей — например, REST API с авторизацией и тестами — между параллельными агентами-разработчиками.
  • Запуск многочасовых автономных сессий разработки, которые должны переживать прерывания.
  • Ограничение доступа автономных агентов-разработчиков к данным и командам с помощью явных протоколов.
  • Наблюдение за несколькими воркерами-агентами одновременно через панель в браузере.

Быстрый старт

  1. 1

    Установите необходимые компоненты: Node.js 18 или новее, tmux и Claude Code CLI

  2. 2

    Установка одной командой (клонирование, сборка, регистрация MCP server и установка skill)

    Установите по официальной инструкции из README
  3. 3

    Или установите вручную: клонируйте репозиторий, установите зависимости и выполните сборку

    git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build
  4. 4

    Зарегистрируйте MCP server в Claude Code

    claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js

Что важно знать

  • Для работы необходимы tmux и Claude Code CLI, установленные вместе с Node.js 18 или новее.
  • Инструмент координирует работу Claude Code workers, поэтому зависит от этого инструмента и связанных с его использованием затрат.

Темы

Частые вопросы

Что такое claude-swarm?
MCP-сервер для координации параллельных групп Claude Code в tmux и git worktrees с поведенческими ограничениями на основе протоколов и веб-панелью в реальном времени. Claude Swarm — это MCP-сервер, который позволяет сессии Claude Code координировать работу нескольких воркеров Claude Code. Каждый воркер запускается в отдельной сессии tmux в изолированном git worktree, реализует одну возможность и отправляет отчёты о статусе. Сервер сохраняет состояние сессий на диске, чтобы работа могла продолжаться после сжатия контекста, сбоев и перезапусков машины благодаря контрольным точкам и восстановлению по heartbeat.
claude-swarm можно использовать бесплатно? Какая у него лицензия?
claude-swarm распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
claude-swarm всё ещё поддерживается?
Нет коммитов больше 6 месяцев. Последний коммит в claude-swarm — 11 февр. 2026 г..
Для чего можно использовать claude-swarm?
Разделение большого набора возможностей — например, REST API с авторизацией и тестами — между параллельными агентами-разработчиками. Запуск многочасовых автономных сессий разработки, которые должны переживать прерывания. Ограничение доступа автономных агентов-разработчиков к данным и командам с помощью явных протоколов. Наблюдение за несколькими воркерами-агентами одновременно через панель в браузере.
Как установить claude-swarm?
Установите необходимые компоненты: Node.js 18 или новее, tmux и Claude Code CLI Установка одной командой (клонирование, сборка, регистрация MCP server и установка skill) Или установите вручную: клонируйте репозиторий, установите зависимости и выполните сборку: git clone https://github.com/cj-vana/claude-swarm.git && cd claude-swarm && npm install && npm run build Зарегистрируйте MCP server в Claude Code: claude mcp add claude-swarm --scope user -- node $(pwd)/dist/index.js
Где скачать claude-swarm?
Исходный код и инструкции по установке — на GitHub: https://github.com/cj-vana/claude-swarm

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Слой рабочих процессов и среда выполнения для OpenAI Codex CLI: структурированное планирование, выполнение долгосрочных целей, параллельные команды агентов и отслеживание состояния в .omx/.

33,6 тыс.2,5 тыс.TypeScriptMITОбновлён 11 часов назад