OpenSwarm: Многозадачный CLI-оркестратор Claude для Linear и GitHub

Что делает OpenSwarm

OpenSwarm — это оркестратор автономных AI-агентов на базе Claude Code CLI. Он создаёт мультиагентную систему, интегрированную с реальными рабочими процессами разработки, в частности с Linear для отслеживания задач и GitHub для управления кодом. Инструмент предназначен для выполнения реальных задач разработки, а не учебных примеров.

Основная архитектура и возможности

Система следует структурированному конвейерному подходу:

• Автономный конвейер: Cron-запускаемый heartbeat получает задачи из Linear и запускает циклы пар Worker/Reviewer
• Пары Worker/Reviewer: Многоитерационная генерация кода с автоматизированными этапами ревью, тестирования и документирования
• Движок принятия решений: Валидация объёма, ограничение частоты запросов, выбор задач на основе приоритетов и маппинг рабочих процессов
• Когнитивная память: Векторное хранилище LanceDB с эмбеддингами Xenova/multilingual-e5-base для долгосрочного запоминания между сессиями
• Граф знаний: Статический анализ кода, маппинг зависимостей и анализ влияния для более умного выполнения задач
• Управление через Discord: Полноценный интерфейс команд для мониторинга, диспетчеризации задач, планирования и управления парными сессиями
• Автоматическое улучшение PR: Мониторит открытые PR, автоматически исправляет сбои CI, автоматически разрешает конфликты слияния и повторяет попытки до прохождения всех проверок
• Долгосрочные мониторы: Отслеживает внешние процессы (обучающие задания, пакетные задачи) и сообщает об их завершении
• Веб-панель управления: Панель статуса в реальном времени на порту 3847 с мониторингом PR Processor
• Поддержка i18n: Поддержка локалей английского и корейского языков

Технические требования

• Node.js >= 22
• Установленный и аутентифицированный Claude Code CLI (claude -p)
• Токен Discord-бота с намерением message content
• API-ключ Linear и ID команды
• GitHub CLI (gh) для мониторинга CI (опционально)

Установка и настройка

Базовая настройка:

git clone https://github.com/unohee/OpenSwarm.git
cd OpenSwarm
npm install

Настройка включает копирование примера конфигурации и создание файла .env:

cp config.example.yaml config.yaml

Необходимые переменные .env:

DISCORD_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=your-channel-id
LINEAR_API_KEY=your-linear-api-key
LINEAR_TEAM_ID=your-linear-team-id

Файл config.yaml поддерживает подстановку переменных окружения (${VAR} или ${VAR:-default}) и валидируется с помощью схем Zod. Ключевые разделы конфигурации включают настройки discord, linear, github, agents, autonomous и prProcessor.

Текущий статус и ограничения

Создатель отмечает, что это всё ещё раннее ПО с шероховатостями. Текущие задачи сосредоточены на безопасности, масштабировании и лучшей декомпозиции задач. В настоящее время система используется в рабочем процессе разработчика для торговой инфраструктуры, инструментов LLM и других проектов.