comanda CLI
Оркестратор для Claude Code, Codex и Gemini CLI: сценарии на YAML повторяются, пока проходят ваши проверки
- 331 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сценарии запускают кодинг-агентов и команды оболочки, которые пишут файлы в репозитории
- Параллельные ветки и бесконечные циклы расходуют токены провайдеров, пока не сработает проверка
Установка
- Работает в
Ручная установка
brew install kris-hansen/comanda/comandaУстановка на macOS через Homebrew.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сценарии запускают кодинг-агентов и команды оболочки, которые пишут файлы в репозитории
- Параллельные ветки и бесконечные циклы расходуют токены провайдеров, пока не сработает проверка
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
comanda — консольная программа на Go, которая превращает работу кодинг-агентов в сценарий на YAML. Вы описываете задачу по-английски, и команда `comanda generate` собирает из нее сценарий. Команда `comanda chart` рисует сценарий как граф, в том числе в формате Mermaid, а `comanda process` запускает его прямо в репозитории. Команда `comanda improve` правит готовый сценарий по замечаниям простым текстом, например добавляет второго ревьюера или обязательную проверку типов. Главная идея — циклы с наблюдаемым критерием выхода. Цикл не заканчивается, когда агент написал «готово»: после каждой итерации запускаются проверки качества. Это синтаксис, безопасность или ваша команда вроде `make test`. При сбое шаг можно повторить, прервать или пропустить. Состояние сохраняется в контрольных точках, поэтому остановленный цикл можно продолжить. В одном сценарии можно соединить Claude Code, Gemini CLI, OpenAI Codex, Kimi Code, модели по API и локальные модели. Шаги идут параллельно и с разными ролями. Результаты передаются файлами или через стандартный ввод и вывод. Для параллельных реализаций есть изолированные Git worktree, для знания о проекте — индекс кодовой базы и долговременная память на SQLite FTS5. Готовые сценарии запускаются из терминала и CI или отдаются по HTTP. Команда `comanda mcp` публикует каждый YAML-сценарий как MCP-инструмент, а навыки comanda как MCP-подсказки.
Для кого. Для разработчиков, которые используют несколько кодинг-агентов и хотят закрепить повторяемый процесс с проверками в репозитории.
Подходит, если
- Нужно гонять фичу через цикл «реализация, тесты, проверка безопасности», пока команда make test не пройдет
- Один агент пишет, другой ревьюит: Claude Code делает архитектурный разбор, Codex оценивает план внедрения, Gemini CLI сводит выводы
- Хотите проверять каждый pull request одним сценарием: `git diff | comanda process review.yaml`
- Длинный прогон прервали, и его надо продолжить с последней контрольной точки
- Нужно отдать проверенные сценарии своей команде как MCP-инструменты для Claude Code или Cursor
Не подходит, если
- Нужно встроить ИИ в собственное приложение на коде: для этого берут агентный фреймворк или SDK
- Автоматизацию надо собирать на визуальном холсте мышью: comanda работает с файлами YAML
- Задача для одного агента без повторов и проверок: проще вызвать его родную консольную команду
- Агентов и ключей к провайдерам еще нет: comanda только координирует уже установленные инструменты
Пример запроса к агенту
Сгенерируй сценарий comanda, который реализует функцию, прогоняет тесты и проверку безопасности и повторяется, пока оба шага не пройдут.Ограничения
Сценарии запускают внешних агентов и ваши команды, поэтому нужны установленные Claude Code, Codex, Gemini CLI или ключи к API провайдеров. API OpenAI и Anthropic из России недоступны. Локальные модели через Ollama, vLLM и llama.cpp работают без внешних провайдеров. Готовые сборки есть для macOS, Linux и Windows на странице релизов. Сценарии с бесконечным циклом или множеством параллельных веток быстро расходуют токены, поэтому задавайте max_iterations и список allowed_paths. Память проекта в SQLite по умолчанию выключена и включается отдельно.
Как отключить. Удалите программу тем способом, которым ставили: `brew uninstall comanda` или удалением бинарника из каталога Go. Запись MCP уберите командой `claude mcp remove comanda`.
Частые вопросы
Как отдать сценарии comanda в Claude Code по MCP?
Выполните `claude mcp add comanda -- comanda mcp`. Сервер работает по stdio, а с флагом `--http :8080` переходит на потоковый HTTP. Каждый YAML-файл из ~/.comanda/workflows, .comanda/workflows или из каталога, указанного флагом `--dir`, становится инструментом, а плейсхолдеры сценария превращаются в его аргументы.
Что происходит, если проверка качества не прошла?
Сработает политика, заданная для проверки: повтор запускает шаг заново, остановка прерывает цикл, пропуск идет дальше. Проверки бывают встроенными, например на синтаксис и безопасность, и своими, например `make test`.
Чем comanda отличается от агентного фреймворка вроде LangGraph?
Фреймворк нужен, чтобы построить ИИ-приложение в коде. comanda занимает место между кодинг-агентом и фреймворком: она оформляет работу агентов как проверяемую YAML-программу, которая запускается там, где разработчик и так работает.
Как ограничить, куда агент может писать?
В конфиге цикла задается allowed_paths, например каталоги ./src и ./tests. Инструменты оболочки подключаются только по явному списку разрешенных команд.
Как продолжить прерванный цикл comanda?
Выполните `comanda loop status имя-цикла`, чтобы увидеть состояние, затем `comanda loop resume имя-цикла`. Цикл возобновится с последней контрольной точки, если в конфиге включено сохранение состояния и задан интервал checkpoint_interval.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыSelf-hosted панель для управления несколькими агентами: постановка задач, обзор прогонов, учет трат и подключение по MCP, CLI или REST
CLI, который прогоняет Claude Code, Codex, OpenCode и другие агенты циклом по списку задач или PRD, пока все не будет сделано
Скиллы и хуки для сборки рабочих сценариев n8n через MCP-сервер n8n-mcp: выражения, узлы, валидация, ИИ-агенты, self-hosting
SDK, CLI и MCP-доступ к тысяче с лишним готовых интеграций SaaS для агентов с авторизацией и сессиями на пользователя
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Плагин Claude Code для запуска задач по расписанию: ревью кода, проверки безопасности и сводки через launchd, cron или Планировщик заданий Windows
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| comanda (эта запись) | нет | 331 | |
| TAKT | нет | 1 427 | тоже описывает процессы нескольких агентов в YAML; comanda делает упор на циклы с проверками и MCP-сервер |
| Claw Orchestrator | нет | 601 | единый рантайм, где работа принимается после проверок, которые агент не писал сам |
Коротко о README
Девиз проекта: заставить кодинг-агентов заслужить выход из цикла. Документация идет от идеи до управляемого сценария и отдельно разбирает запуск сценариев по HTTP и в роли MCP-сервера.