Overview & Result
Foreman acts as an engineering supervisor for autonomous Codex programming sessions. Instead of letting coding agents wander off or loop indefinitely, Foreman invokes Jev at every major development juncture to assess whether the agent should continue, run validation tests, ask for clarification, or halt.
How Jev fits in the loop
- Monitors Codex tool executions, terminal logs, and modified files.
- Prompts Jev with candidate supervisor decisions: continue, verify tests, revert, or stop.
- Steers the autonomous loop toward deterministic completion while saving token budgets.
How to reproduce
- Clone https://github.com/thruwire/foreman and install dependencies.
- Configure your Codex CLI environment and export TYPESAFE_API_KEY.
- Start an autonomous programming task and inspect Foreman evaluating each round of diffs and test passes.
Why this build matters
Provides high-level supervisor oversight for coding agents without incurring the latency and cost of running massive reasoning models as managers.
Limitations
- Requires Codex CLI access and Jev credentials.
- Supervises git-based projects with verifiable unit tests or build commands.