Foreman CLI

Q: Как запустить задание?

Выполните foreman run --repo ./my-project --job "...". Рабочего агента выбирают переменной FOREMAN_WORKER_BACKEND, например opencode.

Q: Как посмотреть прошлые запуски?

Команда foreman runs --repo ./my-project покажет список, а foreman inspect --repo ./my-project откроет подробности.

Q: Можно ли подключить его к сессии Codex?

Да, через хуки: foreman hook --client codex принимает событие в JSON на stdin. Готовый плагин для Codex лежит в маркетплейсе thruwire.

Foreman следит за кодинг-агентами и решает, продолжить, подправить, остановить, повторить или проверить работу.

824 ★ репозитория
Последний коммит 15 окт. 2026
MIT

CLI

thruwire/foremanАвтор:thruwire

Установка

Работает в: Codex
Claude Code
OpenCode
Hermes Agent

В терминале, через SkillFoxx CLI

npx skillfoxx add cli/thruwire-foreman

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Запускает кодинг-агентов, которые меняют репозиторий, и сам решает, продолжать ли их работу.
Отправляет дифф и вывод внешней модели решений.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Foreman, рантайм на Python asyncio, ставит быструю модель решений над медленными кодинг-агентами. Он запускает Codex, OpenCode, Hermes или Deep Agents Code как рабочих, а также подключается к сессиям Pi и ассистентам через хуки. Модель оценивает исходное задание, дифф, вывод и результаты тестов. По оценке Foreman выносит решение: продолжить, направить, остановить, повторить, проверить или завершить. Критерии, например `implementation_complete`, `tests_sufficient`, `worker_stuck`, `needs_human`, настраиваются. Работает с моделью Jev от TypeSafe AI и с OpenAI Decisions API.

Для кого. Инженерам, которые запускают кодинг-агентов на долгих задачах и хотят, чтобы второй слой следил за зацикливанием, уходом от темы и ложным «готово».

Подходит, если

Агент застрял в цикле и повторяет одну и ту же правку.
Тикет объявлен выполненным, а тесты слабые, и нужна независимая оценка.
Работа уходит в сторону от исходной задачи, и ее надо вернуть.
Десять рабочих агентов ведут разные задания, а общая картина по ним нужна в одном месте.

Не подходит, если

Короткая правка, где проще посмотреть дифф самому.
Нельзя отправлять дифф и вывод внешней модели решений.
Требуется детерминированная проверка: оценки вероятностные.

Пример запроса к агенту

foreman run --repo ./my-project --job "Добавить повторы запросов при сетевых ошибках"

Ограничения

Для оценок нужен доступ к модели решений: ключ `TYPESAFE_API_KEY` для Jev либо настроенный адаптер OpenAI. В оценку попадают сжатые выдержки: дифф до 20 000 знаков, хвосты вывода и инструкции из `AGENTS.md`, поэтому код уходит внешнему провайдеру. Живое направление в уже идущий шаг работает только с Codex App Server, остальные варианты сводятся к остановке или повтору. Мост для Pi ставится отдельно, одного `foreman-core` недостаточно. Качество решений зависит от настроенных проверок и порогов, а не гарантировано.

Как отключить. Остановите запущенные задания и удалите пакет командой `python -m pip uninstall foreman-core`. Хуки в настройках ассистента и сохраненные состояния запусков уберите вручную.

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

Как запустить задание?

Выполните `foreman run --repo ./my-project --job "..."`. Рабочего агента выбирают переменной `FOREMAN_WORKER_BACKEND`, например `opencode`.

Как посмотреть прошлые запуски?

Команда `foreman runs --repo ./my-project` покажет список, а `foreman inspect <run-id> --repo ./my-project` откроет подробности.

Можно ли подключить его к сессии Codex?

Да, через хуки: `foreman hook --client codex` принимает событие в JSON на stdin. Готовый плагин для Codex лежит в маркетплейсе thruwire.

Видит ли модель весь репозиторий?

Нет. Она получает сжатые наблюдения: статус git, ограниченный дифф, имена файлов, хвосты вывода и `AGENTS.md`.

Какие модели решений поддержаны?

Jev от TypeSafe AI и OpenAI Decisions API. Для второй нужен адаптер: `pip install 'foreman-core[openai]'`.

Обсуждение

Вопросов и отзывов пока нет.

CLI-инструменты

AgentForeman

AgentForeman координирует кодинг-агентов: председатель уточняет задачу, исполнители работают, итог идет с доказательствами.

CLIШирокий доступ54

Foreman

Нужен VPN

TUI-оркестратор для Claude Code: ведет фичу от плана, ADR и PRD до TDD-сборки и e2e, с одобрением человека и автономной разработкой в worktree

CLIШирокий доступ439

Argus

Argus ведет долгие инженерные и исследовательские задачи четырьмя ролями, где проверяющий читает результат, но ничего не правит.

ПлагинШирокий доступ146

SWE-AF

Команда ИИ-агентов по одному запросу: планирует задачу, пишет код в параллельных ветках, тестирует, проверяет и открывает пull request

ВоркфлоуШирокий доступ1,1 тыс.

Orchestrator

Один агент запускает других в фоне: Claude Code, Codex, Copilot CLI, Grok Build и Pi, с выбором модели под каждый этап.

СкиллШирокий доступ119

LongHorizon-Harness