Skip to content

Clarify supported agents in the Foreman overview #53

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JARosen merged 1 commit into from
Oct 9, 2026
Merged

Clarify supported agents in the Foreman overview #53

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 12 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,21 @@
Foreman watches the software factory floor with [TypeSafe AI's Jev](https://docs.typesafe.ai/introduction),
placing a fast decision model above slower coding agents.

Give it a ticket, specification, bug report, or any free-form software job. A
[Codex](https://learn.chatgpt.com/docs/developer-commands?surface=cli) or
[OpenCode](https://opencode.ai) worker does the software engineering while Foreman independently
assesses whether the implementation is complete, requirements are satisfied, tests are sufficient,
verification is needed, or human input is required.
Give it a ticket, specification, bug report, or any free-form software job. Foreman can run
[Codex](https://learn.chatgpt.com/docs/developer-commands?surface=cli),
[OpenCode](https://opencode.ai), [Hermes](docs/workers.md), or
[LangChain's Deep Agents Code (dcode)](integrations/deepagents/README.md) as workers.
It can also attach supervision to supported coding-agent sessions, including
[Pi and Pi Durable](integrations/pi/README.md).

The coding agent does the software engineering. Foreman independently assesses completion and
requirements against the original job. It also checks whether test evidence is sufficient and
whether verification or human input is needed. You can configure additional checks and
responsibilities for your workflow.

```text
SOFTWARE FACTORY
Codex/OpenCode Codex/OpenCode Tests
Coding agent Coding agent Tests
worker worker │
│ │ │
└──────────────────┼──────────────────┘
Expand Down
9 changes: 9 additions & 0 deletions docs/workers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,15 @@ one capability and three coroutines:
| Hermes | `FOREMAN_WORKER_BACKEND=hermes` | No — stop/retry only |
| Deep Agents Code | `FOREMAN_WORKER_BACKEND=deepagents` | No — stop/retry only |

## Pi and Pi Durable

Pi and Pi Durable use [attached supervision through their native bridges](../integrations/pi/README.md).
The host runs the agent, and the bridge forwards lifecycle events to Foreman for assessment
and feedback. These integrations do not currently implement the `Worker` protocol used by
`foreman run`, so they are not selectable with `FOREMAN_WORKER_BACKEND`.

## Backend behavior

The OpenCode backend shells out to `opencode run` in non-interactive mode.
The prompt is passed positionally and `--auto` keeps the headless run from
stalling on permission prompts. Auto mode approves requests that are not
Expand Down
Loading