thruwire/foreman

Что это?

Ключевые возможности

• 01Запускает Codex, OpenCode, Hermes или Deep Agents в роли исполнителей задач по написанию кода.
• 02Независимо от исполнителя оценивает полноту работы, соответствие требованиям, достаточность тестов и состояние исполнителя.
• 03Может корректировать активный ход Codex или останавливать и перезапускать застрявшего исполнителя.
• 04Поддерживает адаптеры для моделей принятия решений Jev и OpenAI.
• 05Позволяет настраивать ответственности, пороги и внешние команды для сбора данных в TOML.

Сценарии использования

• Не давать автономному ИИ-агенту зациклиться или отклониться от поставленной задачи.
• Добавить независимую проверку завершённости и покрытия тестами перед принятием результата агента.
• Супервизировать интерактивную сессию Codex или Pi, запущенную разработчиком.
• Экспериментировать с семантической супервизией ИИ-агентов, пишущих код, используя собственные проверки.

Быстрый старт

1. 1

   Задайте переменную окружения TYPESAFE_API_KEY для используемой по умолчанию модели принятия решений Jev

2. 2

   Запустите Foreman с бэкендом OpenCode worker в проекте с описанием задачи

   FOREMAN_WORKER_BACKEND=opencode foreman run --repo ./my-project --job "Add request retries"

Что важно знать

• !Сейчас Foreman запускает только одного coding worker за раз.
• !Управление активным ходом в реальном времени работает только с бэкендом Codex App Server; для других бэкендов используется остановка с последующим повторным запуском.
• !Для настройки модели принятия решений по умолчанию требуется TYPESAFE_API_KEY.

В подборках

Темы

Частые вопросы

Что такое foreman?

Python-супервизор для Codex, OpenCode и других ИИ-агентов: проверяет выполнение задачи, достаточность тестов и не застрял ли исполнитель. Foreman — супервизор для ИИ-агентов, пишущих код. Вы передаёте ему задачу, спецификацию или описание ошибки, а он запускает исполнителя, например Codex, OpenCode, Hermes или Deep Agents CLI от LangChain. Пока исполнитель работает, Foreman периодически передаёт модели принятия решений ограниченный набор данных: текст задачи, git status и diff, последние строки вывода, результаты тестов и инструкции из AGENTS.md в репозитории. Модель возвращает вероятности по таким критериям, как полнота реализации, соответствие требованиям, необходимость дополнительной проверки и то, не застрял ли исполнитель или не отклонился ли от задачи.

foreman можно использовать бесплатно? Какая у него лицензия?

foreman распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

foreman всё ещё поддерживается?

Активно поддерживается. Последний коммит в foreman — 15 окт. 2026 г..

Для чего можно использовать foreman?

Не давать автономному ИИ-агенту зациклиться или отклониться от поставленной задачи. Добавить независимую проверку завершённости и покрытия тестами перед принятием результата агента. Супервизировать интерактивную сессию Codex или Pi, запущенную разработчиком. Экспериментировать с семантической супервизией ИИ-агентов, пишущих код, используя собственные проверки.

Как установить foreman?

Задайте переменную окружения TYPESAFE_API_KEY для используемой по умолчанию модели принятия решений Jev Запустите Foreman с бэкендом OpenCode worker в проекте с описанием задачи: FOREMAN_WORKER_BACKEND=opencode foreman run --repo ./my-project --job "Add request retries"

Где скачать foreman?

Исходный код и инструкции по установке — на GitHub: https://github.com/thruwire/foreman