bmalph CLI
CLI ставит в проект планирование BMAD и цикл Ralph: сначала роли BMAD пишут PRD и истории, потом агент реализует их по тестам
- 407 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Цикл Ralph запускает агента без вопросов: в Claude Code он идет с режимом `bypassPermissions`, сам правит файлы и делает коммиты
- В режиме `--swarm` воркеры меняют отдельные ветки, и при конфликте слияние приходится решать вручную
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/bmalphОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Цикл Ralph запускает агента без вопросов: в Claude Code он идет с режимом `bypassPermissions`, сам правит файлы и делает коммиты
- В режиме `--swarm` воркеры меняют отдельные ветки, и при конфликте слияние приходится решать вручную
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
bmalph — npm-пакет с командой bmalph, которая собирает в проекте две системы. BMAD-METHOD отвечает за планирование: роли аналитика, менеджера продукта, архитектора и других ведут диалог с вами через анализ, PRD, архитектуру и эпики с историями. Ralph отвечает за реализацию: bash-цикл снова и снова запускает свежую сессию агента, берет из `@fix_plan.md` следующую историю, пишет тесты и код и делает коммит. Команда `bmalph init` кладет в проект папки `_bmad/`, `.ralph/` и `bmalph/` и дописывает инструкции платформы, например в `CLAUDE.md` или `AGENTS.md`. В Claude Code команды BMAD ложатся в `.claude/commands/`, в Codex они становятся скиллами в `.agents/skills/`, в OpenCode в `.opencode/skills/`. Для Cursor, Windsurf, Copilot и Aider остается справочник `_bmad/COMMANDS.md`. Команда `bmalph implement` переводит истории из BMAD в план Ralph, а `bmalph run` запускает цикл с панелью состояния. Предохранитель прерывает цикл, когда история стоит на месте. Флаг `--review` добавляет проверку кода в Claude Code, флаг `--swarm` запускает от двух до шести воркеров в отдельных git worktree, каждый на своих эпиках.
Для кого. Командам и одиночным разработчикам, которые ведут проект от идеи до кода по BMAD и хотят отдать реализацию автономному циклу на Claude Code, Codex, OpenCode, Copilot или Cursor.
Подходит, если
- Проект стартует с нуля, и до первой строки кода идею надо довести до PRD, архитектуры и списка историй
- Список историй готов, и реализацию хочется отдать циклу, который идет по ним с тестами и коммитом после каждой
- В проекте стоит чистый BMAD, и его переводят под bmalph: `bmalph init` заменяет `_bmad/`, а планы в `_bmad-output/` не трогает
- Эпиков несколько, и их можно прогнать параллельно воркерами в изолированных ветках
- Команда сидит в Windsurf или Aider и берет только планирование BMAD без цикла
Не подходит, если
- Задача на пару правок: полный проход BMAD избыточен, для малых задач в BMAD есть Quick Spec и Quick Dev
- Нужен присмотр за каждым шагом: Ralph в Claude Code идет с режимом `bypassPermissions` и без вопросов к человеку
- Рабочее дерево с незакоммиченными правками: режим `--swarm` требует чистое дерево и минимум два незавершенных эпика
Пример запроса к агенту
Запусти /create-prd для приложения учета задач и веди меня через фазу планирования, а когда истории будут готовы, напомни про bmalph implementОграничения
Нужны Node.js 20 или новее и bash. На Windows цикл идет через Git Bash или WSL. Цикл Ralph доступен на Claude Code, Codex, OpenCode, Copilot и Cursor, причем Copilot и Cursor автор называет экспериментальными. Windsurf и Aider получают только планирование BMAD. Проверка кода `--review` работает лишь с Claude Code. Команда `bmalph watch` объявлена устаревшей, вместо нее служит `bmalph run`. Драйвер Cursor на Windows экспериментальный и рассчитан на Git Bash, а `bmalph doctor` проверяет наличие `jq` и `cursor-agent`.
Как отключить. Команда `bmalph reset` удаляет из проекта все файлы bmalph, а с флагом `--dry-run` сначала показывает, что исчезнет. Сам пакет снимается командой `npm uninstall -g bmalph`. Прервать работающий цикл можно через Ctrl+C.
Частые вопросы
Как установить bmalph и начать работу?
Выполните `npm install -g bmalph`, затем в папке проекта `bmalph init --name my-project`. Без флага `--platform` bmalph определяет платформу по маркерам проекта, а при неясности спрашивает вас.
Чем планирование BMAD отличается от цикла Ralph?
BMAD ведет диалог: анализ, PRD, архитектура, эпики и истории. Ralph работает без диалога: берет историю из `@fix_plan.md`, пишет тесты и код, коммитит и идет дальше. Между ними стоит команда `bmalph implement`.
Что делает цикл, если история не получается?
Предохранитель прерывает цикл при застое на истории, а анализатор ответов замечает зависшие и повторяющиеся выводы. Причину ищите в логах из `.ralph/logs/`.
Как запустить воркеров параллельно?
Командой `bmalph run --swarm 3`: по умолчанию воркеров два, максимум шесть. Нужны чистое дерево, минимум два незавершенных эпика, платформа полного уровня и не отсоединенный HEAD. По завершении ветки сливаются по очереди, при конфликте слияние останавливается и ветки сохраняются.
Какие платформы поддерживаются?
Claude Code, OpenAI Codex, OpenCode, Cursor, Windsurf, GitHub Copilot и Aider. Цикл Ralph есть у Claude Code, Codex, OpenCode, Cursor и Copilot, а у Windsurf и Aider работает только планирование.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКоманда ralph повторяет один промпт для Claude Code, Codex, Cursor Agent или OpenCode, пока в ответе не появится метка завершения
Цикл Ральфа для длинных задач: агент в песочнице Docker идет по списку задач из PRD, проверяет каждую тестами и коммитит, пока список не кончится
Терминальная панель, которая ведет Claude Code, Codex и еще пять агентов по списку задач циклом, пока список не закончится
CLI-оркестратор, который прогоняет Claude Code, Codex, Gemini CLI и другие агенты по циклу до готовности задачи и блокирует неполную работу тестами и линтером
Автономное выполнение плана по задачам: каждая задача в свежем сеансе Claude Code или Codex, затем многопроходное ревью. Написан на Go
Автономный цикл разработки по спецификациям: агент берет задачу, сверяет критерии приемки и коммитит, пока список не кончится.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| bmalph (эта карточка) | нет | 407 | |
| BMad Method | нет | 55 080 | сам набор ролей и рабочих процессов BMAD без цикла реализации |
| Open Ralph Wiggum | нет | 1 908 | повторяет один промпт до метки завершения и не планирует проект |
Коротко о README
README открывается схемой потока от планирования BMAD к циклу Ralph, затем идут таблица платформ с уровнями поддержки, быстрый старт и описание четырех фаз BMAD с кодами команд. Дальше справочник по командам и флагам, структура проекта после `bmalph init`, устройство цикла Ralph с режимом роя и раздел об ошибках, включая настройку Windows и Cursor.