zenflow CLI
Движок многоагентных процессов на Go: один YAML-файл описывает агентов, шаги и зависимости, запуск одной командой.
- 59 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агенты выполняют `bash` и пишут файлы, а режим `--yolo` снимает подтверждения.
- Ключи провайдеров передаются через переменные окружения.
Установка
- Работает в
Ручная установка
curl -fsSL https://zenflow.sh/install.sh | shПервая команда раздела Install в README для macOS и Linux; есть также `brew install zendev-sh/tap/zenflow` и `go install`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агенты выполняют `bash` и пишут файлы, а режим `--yolo` снимает подтверждения.
- Ключи провайдеров передаются через переменные окружения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
zenflow запускает несколько агентов по описанию в YAML. В файле перечислены агенты с ролями и шаги с зависимостями `dependsOn`, а координатор на базе модели маршрутизирует события между ними через почтовые ящики с гарантией доставки. Агенты вызывают собственные MCP-инструменты, среди которых `read`, `write`, `glob`, `grep` и `bash`. Команды CLI: `zenflow flow` для файла процесса, `zenflow goal` для цели одной фразой и `zenflow agent` для одного агента с циклом инструментов. Флаг `--plan` печатает граф шагов перед запуском. В репозитории лежит `SKILL.md`, который учит агента составлять такие процессы. Один статический бинарный файл на Go, есть библиотека для встраивания в сервисы и образ Docker. Проверена работа с Google Gemini, AWS Bedrock и Azure.
Для кого. Разработчикам, которым нужно запустить связку агентов по схеме (спорщики и судья, планировщик и исполнитель) без написания оркестратора.
Подходит, если
- Нужен процесс из планировщика, исполнителя и ревьюера, заданный декларативно.
- Агентов требуется запускать в CI одной командой.
- Нужно встроить оркестрацию агентов в сервис на Go.
- Перед запуском надо увидеть граф шагов с флагом `--plan`.
Не подходит, если
- Нужна точная и стабильная схема YAML: проект предупреждает, что она может меняться до версии 1.0.
- Достаточно одного агента без сложной маршрутизации.
- Запуск должен быть без доступа к командной оболочке и записи файлов.
Пример запроса к агенту
Составь debate.yaml с тремя агентами: за, против и судья. Покажи граф через --plan и запусти в режиме --sandbox.Ограничения
Проект очень новый: схема YAML и API могут меняться до версии 1.0. В режиме `--yolo` агенты выполняют `bash` без подтверждения, поэтому для автоматических прогонов в CI используйте `--sandbox`: он оставляет только `read`, `write`, `grep` и `glob` и блокирует `bash`. Для установки через `go install` нужен Go 1.25 или новее. Для запуска нужен ключ выбранного провайдера, например `GEMINI_API_KEY`. Установочный скрипт `curl ... | sh` тянет архив из релиза GitHub и проверяет контрольную сумму SHA-256.
Как отключить. Удалите бинарный файл `zenflow` из `~/.local/bin` (в Windows из `%LOCALAPPDATA%\Programs\zenflow`) или командой `brew uninstall zenflow`. Образ Docker удаляют через `docker rmi`.
Частые вопросы
Что описывает YAML-файл?
Агентов с ролями в разделе `agents` и шаги в разделе `steps`: у шага есть `agent`, `instructions` и список `dependsOn`, из которого строится граф.
Как запустить без опасных инструментов?
Добавьте флаг `--sandbox`. Он ограничивает набор инструментов до `read`, `write`, `grep` и `glob`, а `bash` блокирует даже при `--allow bash`.
Какие провайдеры проверены?
Google Gemini, AWS Bedrock и Azure. Провайдера выбирают параметром `--model`, например `google/gemini-2.5-flash`.
Чем различаются flow, goal и agent?
`flow` выполняет файл процесса, `goal` берет цель одной фразой, `agent` запускает одного агента с циклом инструментов.
Как встроить в Go-сервис?
Подключите пакет `github.com/zendev-sh/zenflow` и вызовите `zenflow.New(...).RunFlow(ctx, wf)`: CLI использует тот же движок.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMaestro-Flow по цели строит цепочку от анализа до тестов и гоняет через нее Claude Code, Codex, Gemini и других агентов
Frink запускает до четырех агентов в своих worktree и собирает Flow-автоматизации из одной фразы со своим скиллом редактора.
Декларативные DAG-воркфлоу для кодинг-агентов: фазы в изоляции, проверка графа, возобновление и воспроизведение прогонов.
Flowtrace раскладывает работу агента на шаги-файлы в git-репозитории: их видно, проверяют, правят по одному и запускают заново на новых данных
CLI от Microsoft запускает многоагентные процессы из одного YAML: маршруты без языковой модели, параллельные шаги, веб-панель.
Axe на Go: однозадачные ИИ-агенты описываются в TOML и запускаются из терминала, по каналу оболочки, из cron и хуков git, с памятью и подагентами
Коротко о README
Декларативный многоагентный движок в одном бинарнике Go. Процессы пишутся в YAML, запускаются из CLI и встраиваются в сервисы.