thruwire/foreman
Software factory foreman based on TypeSafe's Jev model
Older snapshot: check the original source for current information.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
Foreman watches the software factory floor with decision models, placing a fast semantic supervisor above slower coding agents. It supports TypeSafe AI's Jev and OpenAI's Decisions API. Give it a ticket, specification, bug report, or any free-form software job. Foreman can run Codex, OpenCode, Hermes, or LangChain's Deep Agents Code (dcode) as workers. It can also attach supervision to supported coding-agent sessions, including Pi and Pi Durable. 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. Generative models work. Foreman watches the work. Foreman separates software-engineering work from continuous semantic supervision. Its effectiveness depends on the quality of the configured checks, evidence, thresholds, and underlying models. Contributions are welcome. See CONTRIBUTING.md for setup and pull-request guidance.…
Read the full README ↗ · Preview checked 2026-10-29T11:37:48.666Z
Inside the original README — Document outline
- Foreman
- Documentation
- Contributing
- What is Foreman?
- Why build this?
- The factory floor
- Worker backends
- What Foreman watches
- Responsibilities and checks
- What Foreman can do
- Decision models
- Requirements
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
Software factory foreman based on TypeSafe's Jev model
Repository facts
- Owner
- thruwire
- Primary language
- Python
- Stars
- 541
- Forks
- 40
- Open issues + pull requests
- 7
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-09-17T11:46:13.000Z
- Last push
- 2026-09-24T11:30:24.000Z
Topics and intended use
No topics were included in the latest source metadata.
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-09-24T12:03:36.034Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.
Related repositories
EbookFoundation/free-programming-books
donnemartin/system-design-primer