Foreman CLI
TUI-оркестратор для Claude Code: ведет фичу от плана, ADR и PRD до TDD-сборки и e2e, с одобрением человека и автономной разработкой в worktree
- 443 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Автономные рабочие агенты пишут код, запускают тесты и сливают ветки в вашем репозитории
- Запуски тратят деньги и токены подписки Claude, лимиты нужно настроить заранее
- `foreman init` записывает скиллы и агентов в `.claude/` и файлы состояния в `.foreman/`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/foremanОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Автономные рабочие агенты пишут код, запускают тесты и сливают ветки в вашем репозитории
- Запуски тратят деньги и токены подписки Claude, лимиты нужно настроить заранее
- `foreman init` записывает скиллы и агентов в `.claude/` и файлы состояния в `.foreman/`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Foreman — терминальный интерфейс на Textual, который запускает установленный у вас `claude` в безголовом режиме stream-json и ведет фичу по конвейеру: план, ADR и PRD, разбиение на задачи, сборка по TDD, сквозная проверка. Состояние хранится в файлах внутри целевого репозитория, без базы данных: после аварии Foreman восстанавливается с диска. На проектных этапах человек контролирует каждый шаг. Планировщик пишет `plan.md`, скилл `foreman-grill-docs` проверяет план по коду и готовит ADR и PRD, а вы в интерфейсе одобряете (a) или просите правки (r). Одобрение запечатано хэшем SHA-256 и слетает, если текст документа изменили. Когда ADR и PRD согласованы, `foreman-to-issues` режет PRD на мелкие задачи с запускаемой проверкой приемки, и вы подтверждаете очередь. Дальше работает автономный цикл. Каждая готовая задача выполняется в отдельном git worktree, параллельно, если их `touches` не пересекаются. Рабочий агент по `foreman-tdd` пишет код и сохраняет доказательства, а слияние решает сам Foreman: проверка приемки, тесты, линтер, типы и защита от регрессий. Потом оценщик в отдельном контексте ставит баллы от 1 до 5. Бюджеты по ходам, стоимости и времени, суточный потолок расходов и хук `PreToolUse`, который не дает агентам писать `verification.json`, задает сам Foreman, а не агент.
Для кого. Для разработчиков, которые уже работают с Claude Code и хотят передавать ему большую фичу циклом с контрольными точками и лимитами расходов.
Подходит, если
- Фича слишком большая для одного диалога, и ее нужно разбить на ADR, PRD и независимые задачи с проверками
- Нужна параллельная сборка нескольких задач, каждая в своей ветке worktree, без конфликтов по затрагиваемым файлам
- Хочется потолка расходов: бюджет на запуск, лимиты ходов и суточный предел с жесткой остановкой
- Слияние должно зависеть от результатов тестов, линтера, типов и регрессий, а не от слов агента
- Сначала нужно посмотреть работу без затрат: `foreman --demo` запускает весь конвейер на тестовых данных, токены не тратятся
Не подходит, если
- Правка на несколько строк: цикл с планом, ADR и PRD избыточен
- У вас нет установленного и авторизованного `claude`: Foreman запускает этот агент
- Вы работаете не на Linux или WSL2: разработчик тестировал только Ubuntu под WSL2
- Нужен другой агент вместо Claude Code: Foreman рассчитан на `claude` и его формат событий
Пример запроса к агенту
Запусти foreman в этом репозитории и создай фичу «ежедневный план»: пусть сначала подготовит план и PRD, а я их проверюОграничения
Нужны Python 3.11 или новее, `git` и установленный авторизованный `claude`. Разработчик разрабатывал и тестировал Foreman на Ubuntu под WSL2.
- Запуск рабочих агентов тратит деньги и токены вашей подписки или ключа Claude. Лимиты задают `max_cost_usd`, `max_turns`, `timeout_min` и суточный потолок.
- Фаза 3 (экспорт обучающих данных, песочница рабочих агентов, пробы контракта CLI, хаос-набор) в дорожной карте помечена как запланированная.
- Лицензия MIT, часть встроенных скиллов получена из mattpocock/skills (MIT) и переработана.
- Скиллы и агенты Foreman записываются в `.claude/skills/` и `.claude/agents/` вашего репозитория.
Как отключить. Удалите утилиту командой `pipx uninstall foreman-orchestrator`. В репозитории можно стереть каталог `.foreman/` и скиллы `foreman-*` из `.claude/skills/` вместе с агентами `foreman-*.md` из `.claude/agents/`.
Частые вопросы
Как установить Foreman?
Командой `pipx install foreman-orchestrator`, либо `pipx install .` из клона репозитория. Затем в нужном проекте выполните `foreman init`: он создаст `.foreman/` и установит скиллы `foreman-*` в `.claude/skills/`.
Можно ли попробовать Foreman без расхода токенов?
Да. Команда `foreman demo` прогоняет весь конвейер на тестовом репозитории с поддельным бэкендом агента, а `foreman --demo` открывает тот же интерфейс. Токены не тратятся.
Что значит, что одобрение запечатано хэшем?
Foreman проверяет SHA-256 тела документа при каждой загрузке. Если вы или агент изменили одобренный документ, одобрение отменяется и документ нужно просмотреть заново.
Как Foreman не дает агенту обмануть проверку?
Слияние решает сам Foreman по результатам приемочной проверки, тестов, линтера, типов и регрессий. Хук `PreToolUse` запрещает рабочим агентам писать `verification.json` и файлы задач.
Что такое foreman retro и foreman bench?
`foreman retro` группирует повторяющиеся сбои и пишет черновики правок к скиллам и промптам. Правка вступает в силу только после отчета `foreman bench`, который показывает, что она не ухудшает набор оценочных задач.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыРабочие процессы для Claude Code: команды /do, /omo, /bmad-pilot и другие, а код пишут Codex, Gemini или OpenCode через codeagent-wrapper
Один рантайм для Claude Code, Codex, OpenCode и других: работа принята, только если пройдены проверки, которые агент не писал
Среда для Claude Code, которая держит контекст между сессиями через хуки, леджеры и передачи, оркеструет агентов и экономит токены
Локальная панель для нескольких сессий Claude Code: у каждой задачи свой контекст и todo, агенты порождают дочерних агентов и обмениваются сообщениями
Терминальное приложение для параллельной работы нескольких Claude Code, Codex, Gemini CLI и Aider в отдельных сессиях tmux и git worktree
Оркестратор для агентов: рабочий процесс описывается кодом, каждый шаг проверяется, важные места требуют подтверждения человека, а решения пишутся в неизменяемы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Foreman (эта запись) | нет | 443 | |
| Zeroshot | нет | 2 063 | запускает агентов графом, где независимые проверяющие возвращают сбои на исправление |
| Octogent | нет | 1 414 | локальная панель для нескольких сессий Claude Code с общением агентов, без конвейера с согласованием документов |
Коротко о README
Страница объясняет, зачем нужен надзиратель над агентом: конвейер с контрольными точками, настоящие безголовые агенты, состояние в файлах, изоляция worktree, ограничения от оркестратора и цикл оценки. Затем идут демонстрация без токенов, быстрый старт, справочник горячих клавиш интерфейса и подробное описание двух фаз. Дальше раздел с дорожной картой, структурой файлов, настройками `.foreman/config.yaml`, списком встроенных скиллов и правилами разработки.