diff --git a/README.md b/README.md index 3d7c713..2e6da4c 100644 --- a/README.md +++ b/README.md @@ -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 │ │ │ │ └──────────────────┼──────────────────┘ diff --git a/docs/workers.md b/docs/workers.md index 97174b8..a4f8f3d 100644 --- a/docs/workers.md +++ b/docs/workers.md @@ -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