thruwire/foreman

这是什么？

核心功能

• 01支持以 Codex、OpenCode、Hermes 或 Deep Agents 作为编码执行者。
• 02独立评估任务完成度、需求满足度、测试充分性和执行者状态。
• 03可在 Codex 运行中途注入指导，或停止并重试卡住的执行者。
• 04支持 Jev 与 OpenAI 两种决策模型适配器。
• 05通过 TOML 配置职责、阈值和外部证据命令。

适用场景

• 防止无人值守的编码智能体陷入循环或偏离工单。
• 在接受智能体输出前，增加独立的完成度与测试覆盖检查。
• 为开发者手动启动的 Codex 或 Pi 会话提供监督。
• 使用自定义检查项试验对编码智能体的语义监督。

快速上手

1. 1

   设置默认 Jev 决策模型所需的 TYPESAFE_API_KEY 环境变量

2. 2

   使用 OpenCode 工作后端，对项目执行一个任务描述来运行 Foreman

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

使用前须知

• !Foreman 目前一次只运行一个编码工作进程。
• !实时引导仅支持 Codex App Server 后端；其他后端只能停止和重试。
• !默认决策模型配置需要 TYPESAFE_API_KEY。

收录于专题

标签

常见问题

foreman 是什么？

一个 Python 监督工具，用决策模型实时监看 Codex、OpenCode 等编码智能体，判断任务完成度、测试是否充分及工作者是否卡住。 Foreman 是面向 AI 编码智能体的监督工具。你提供工单、需求说明或 bug 报告，它会启动 Codex、OpenCode、Hermes 或 LangChain 的 Deep Agents CLI 作为执行者。执行期间，Foreman 会定期把有边界的证据（任务描述、git 状态与 diff、输出尾部、测试结果、仓库 AGENTS.md 指令）交给决策模型，由模型给出完成度、需求满足度、是否需要验证、执行者是否卡住或偏离任务等检查项的概率。

foreman 可以免费使用吗？用的什么许可证？

foreman 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

foreman 还在维护吗？

活跃维护中。foreman 最近一次提交是在 2026年10月15日。

foreman 适合用来做什么？

防止无人值守的编码智能体陷入循环或偏离工单。 在接受智能体输出前，增加独立的完成度与测试覆盖检查。 为开发者手动启动的 Codex 或 Pi 会话提供监督。 使用自定义检查项试验对编码智能体的语义监督。

foreman 怎么安装和运行？

设置默认 Jev 决策模型所需的 TYPESAFE_API_KEY 环境变量 使用 OpenCode 工作后端，对项目执行一个任务描述来运行 Foreman: FOREMAN_WORKER_BACKEND=opencode foreman run --repo ./my-project --job "Add request retries"

在哪里获取 foreman？

源代码和安装说明在 GitHub 上：https://github.com/thruwire/foreman