Ralph Orchestrator
CLI-оркестратор, который прогоняет Claude Code, Codex, Gemini CLI и другие агенты по циклу до готовности задачи и блокирует неполную работу тестами и линтером
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Прогоняет агента через несколько итераций автономно, без подтверждения на каждый шаг
- Агент-бэкенд получает доступ к коду проекта и выполняет команды в рамках циклов
Установка
Ручная установка
npm install -g @ralph-orchestrator/ralph-cliРекомендованный способ установки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ralph Orchestrator ставит выбранный агент-бэкенд в цикл: агент работает над задачей, orchestrator проверяет результат через шлюзы вроде тестов, линта и проверки типов, и если проверка не пройдена, отправляет агента на новую итерацию, пока тот не сообщит о завершении или не кончится лимит итераций. Работа организована через «шляпы» (hat system): специализированные роли вроде планирования, реализации, ревью и отладки, которые сменяют друг друга по событиям. У инструмента есть режим планирования с интерактивной сессией перед кодом, веб-дашборд для наблюдения за циклами и Telegram-бот, через который можно на ходу задавать агенту вопросы или вмешаться в работу.
Для кого. Для разработчиков, которые хотят запускать Claude Code, Codex или другой CLI-агент в автономном цикле на задачу и получать результат, прошедший тесты и линтер, без ручного перезапуска.
Подходит, если
- Задачу нужно доводить до конца циклом с проверками, а не одним запросом к агенту
- Нужен веб-дашборд или Telegram-бот, чтобы наблюдать за автономной работой агента и иногда вмешиваться
- Проект требует специализированных ролей вроде отдельно планирования и отдельно ревью кода
Не подходит, если
- Задача простая и одноразовая, где обычный запрос к агенту быстрее
- Нет тестов, линтера или другого критерия завершенности, по которому шлюзы могли бы оценивать результат
- Нет установленного Rust и Node.js для сборки API и веб-дашборда
Пример запроса к агенту
Запусти Ralph на бэкенде claude и прогони задачу добавления JWT-аутентификации в цикле до прохождения тестовОграничения
Веб-дашборд помечен как альфа-версия и требует Rust-тулчейн и Node.js 18+. Цикл останавливается по сигналу LOOP_COMPLETE от агента или по лимиту итераций, гарантии правильности результата нет, шлюзы проверяют лишь то, что вы в них настроили. Telegram-бот требует собственного токена бота.
Как отключить. Удалите глобальный пакет: npm uninstall -g @ralph-orchestrator/ralph-cli, либо cargo uninstall ralph-cli, если ставили через Cargo.
Проверка безопасности
- Прогоняет агента через несколько итераций автономно, без подтверждения на каждый шаг
- Агент-бэкенд получает доступ к коду проекта и выполняет команды в рамках циклов
Коротко о README
README описывает Ralph Orchestrator как реализацию техники Ralph Wiggum: держать агента в цикле, пока задача не готова, с системой «шляп» для планирования, реализации, отладки и ревью. Установка через npm, GitHub Releases installer или Cargo. Есть режим планирования ralph plan перед кодом, MCP-сервер для интеграции с MCP-клиентами через ralph mcp serve, веб-дашборд для мониторинга циклов и Telegram-бот RObot для вопросов агента и ручного вмешательства человека. Поддерживает бэкенды Claude Code, Kiro, Gemini CLI, Codex, Forge, Amp, Copilot CLI, OpenCode, Pi, Roo и OMP. Лицензия MIT.
Частые вопросы
Чем Ralph отличается от разового запроса агенту?
Ralph не останавливается после одного ответа агента, а прогоняет его через шлюзы вроде тестов и линта и повторяет цикл, пока задача не пройдет проверки или не кончится лимит итераций.
Можно ли работать без веб-дашборда?
Да, дашборд отдельная альфа-функция для наблюдения. Базовый цикл ralph run работает из командной строки без Rust и Node.js для API.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Открытая библиотека промптов с плагином Claude Code, MCP-сервером и CLI: поиск, получение и улучшение промптов и скиллов из агента