Maestro-Flow CLI
Maestro-Flow по цели строит цепочку от анализа до тестов и гоняет через нее Claude Code, Codex, Gemini и других агентов
- 576 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Многочасовые автономные циклы Odyssey и режим `-y` пишут код и запускают команды без подтверждения
- Установка кладет команды, хуки и инструкции в каталоги Claude Code и других агентов
- Один поток запускает несколько платных агентов сразу и расходует их квоты
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/maestro-flowОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Многочасовые автономные циклы Odyssey и режим `-y` пишут код и запускают команды без подтверждения
- Установка кладет команды, хуки и инструкции в каталоги Claude Code и других агентов
- Один поток запускает несколько платных агентов сразу и расходует их квоты
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Maestro-Flow — npm-пакет для оркестрации разработки несколькими кодовыми агентами по заданной цели. Вы пишете в Claude Code `/maestro-ralph "реализуй OAuth2 с refresh-токенами"`, а движок Ralph определяет стадию проекта и строит цепочку стадий `analyze`, `plan`, `execute`, `verify`, `review` и `test`. В точках решения он продолжает работу, откатывается или вставляет цикл исправления. Видов цепочек больше сорока. Установка: `npm install -g maestro-flow@0.5.82`, затем `maestro install` с выбором компонентов. В одном потоке смешиваются CLI разных агентов: Claude, Codex, Gemini, Qwen, OpenCode и Grok. Режимов координации четыре: Delegate передает задачу асинхронно, Team делит роли, Wave запускает параллельно независимые шаги, Swarm исследует вариантами. Глубину проверки задают три режима качества: `full`, `standard` и `quick`. Найденные по ходу работы паттерны, ловушки и решения сохраняются как Spec и Knowhow, а хуки подмешивают их в запросы следующих агентов. Команды Odyssey запускают многочасовые самокорректирующиеся циклы в режимах `debug`, `planex`, `improve`, `review`, `security`, `defensive` и `ui`. Режимы `security` и `defensive` только читают код. Для поиска по проекту есть `maestro search`, а флаг `--exact` ищет строку через встроенный ripgrep.
Для кого. Разработчикам, которые ведут большую задачу через несколько агентов сразу и хотят, чтобы анализ, реализация, ревью и тесты шли по цепочке, а знания копились между сессиями.
Подходит, если
- Задача крупная, например OAuth2 с refresh-токенами, и агент должен сам пройти анализ, план, реализацию, проверку, ревью и тесты
- Claude Code пишет реализацию, Codex делает ревью, а Gemini проверяет план: все трое работают в одном потоке
- Баг ищут часами: `/maestro-odyssey --mode debug` крутит цикл анализа, диагноза и исправления до выполнения критериев
- Прототип проверяют быстро в режиме `quick`, а перед релизом включают `full` с бизнес-тестами
- Выводы агентов вроде найденных ловушек должны попадать в запросы следующих сессий через Spec и Knowhow
Не подходит, если
- Правка в одну строку: хватит `/maestro-companion` или обычного запроса, цепочка из шести стадий избыточна
- На машине нет ни Claude Code, ни Grok Build: один из них требуется как хост-CLI
- Node.js ниже 22.19 и обновить его нельзя
- Нужна простая спецификация и задачи без оркестрации: для этого лучше подойдут легкие инструменты вроде OpenSpec
Пример запроса к агенту
Поставь Maestro-Flow и запусти `/maestro-ralph` для задачи: добавить страницу профиля пользователя с тестамиОграничения
- Нужны Node.js 22.19 или новее и хотя бы один хост-CLI: Claude Code по умолчанию или Grok Build. Codex CLI и `agy` CLI ставят дополнительно для многоагентных потоков.
- Основной README на китайском, английская версия лежит в `README.en.md`.
- Многочасовые циклы Odyssey и несколько агентов одновременно расходуют много токенов и квот подписок. Флаг `-y` отключает подтверждения.
- Версия в команде установки закреплена в README, `maestro-flow@0.5.82`: перед установкой сверьте ее с последним релизом в npm.
Как отключить. Выполните `npm uninstall -g maestro-flow`. Команды и хуки, которые `maestro install` положил в каталоги `.claude` и другие хост-каталоги, удалите вручную, а при необходимости уберите каталог `.workflow` проекта со Spec и Knowhow.
Частые вопросы
Как поставить Maestro-Flow для Claude Code?
Выполните `npm install -g maestro-flow@0.5.82`, затем `maestro install` и выберите компоненты. Нужны Node.js 22.19 или новее и Claude Code. После установки в Claude Code доступны команды вроде `/maestro` и `/maestro-ralph`.
Что делает `/maestro-ralph`?
Команда принимает цель на обычном языке, определяет стадию проекта и строит цепочку из команд `analyze`, `plan`, `execute`, `verify`, `review` и `test`. После сбоя она сама вставляет `debug`, `fix` и повтор, у нового проекта начинает с `brainstorm` и `blueprint`. Приостановленную работу возобновляет `/maestro-ralph -c`.
Какие агенты работают вместе?
В одном потоке можно смешивать Claude, Codex, Gemini, Qwen, OpenCode и Grok. Хостом служит Claude Code или Grok Build, остальные подключаются через `delegate`. Codex CLI и `agy` CLI ставятся отдельно.
Что такое режим Odyssey?
Это долгие автономные циклы с корректировкой на каждой контрольной точке: `/maestro-odyssey <задача> --mode debug` и еще шесть режимов: `planex`, `improve`, `review`, `security`, `defensive`, `ui`. Цикл идет до выполнения критериев приемки. Режимы `security` и `defensive` только читают код.
Как посмотреть ход работы?
Командой `maestro session status`. Сессию открывают `maestro session open`, следующий шаг запускает `maestro run next`, завершение шага фиксирует `maestro run complete --advance`, а закрывает все `maestro session complete`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл с 25 командами для разбора и доработки промптов, инструментов и схем агентов в Cursor, Claude Code, Gemini CLI и Codex
Плагин оркестрации для Claude Code, Codex, Gemini CLI и Qwen Code: 39 специалистов, параллельные субагенты, сохраняемые сеансы и отдельные аудиты
maestro хранит в общем корне Git работу, решения, сессии и доказательства людей и агентов локально, без фонового сервиса
Цикл Ральфа для длинных задач: агент в песочнице Docker идет по списку задач из PRD, проверяет каждую тестами и коммитит, пока список не кончится
CLI-оркестратор, который прогоняет Claude Code, Codex, Gemini CLI и другие агенты по циклу до готовности задачи и блокирует неполную работу тестами и линтером
Набор процесса для агентов: роутер скиллов, память проекта в папке DEV и проверка результата перед словом «готово».
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Maestro-Flow (эта карточка) | нет | 576 | |
| OpenSpec | нет | 74 784 | ведет разработку от предложения и требований к задачам, а Maestro-Flow сам выбирает цепочку по цели и подключает нескольких агентов |
| Ruflo | нет | 81 578 | маркетплейс плагинов и рои агентов для Claude Code, а Maestro-Flow строит жесткую цепочку стадий с точками решения |
Коротко о README
README коротко излагает четыре возможности: адаптивную оркестрацию, работу разных агентов, накопление знаний и долгие циклы. Дальше идут установка, три входа Ralph, `/maestro` и `/maestro-next`, режимы Odyssey, точный поиск и указатель руководств по установке, командам, хукам и MCP.