Foreman

Foreman

Free, open-source software factory that puts AI agents on every stage of the development loop and keeps you on the judgment calls.

Deploy on VercelRead the docs

Label an issue, get a reviewed PR

Foreman classifies, plans, implements, and reviews the work, then links a draft PR back on the thread. You make two judgment calls, what to hand it and whether the result ships.

Add a --json flag to eve info

  • Benji added the factory label

  • Foreman Picked this up and classified it as a feature, small in scope. eve info prints discovery diagnostics for humans, and CI scripts need a machine-readable version. Planning now.

  • Foreman Plan ready with 3 acceptance criteria. Implementing on factory/feature-eve-info-json.

  • Foreman Implemented and verified: lint, typecheck, and the CLI tests pass. Review in progress in a separate checkout.

  • Foreman Reviewer approved: 3 of 3 acceptance criteria pass. Draft PR #815 is ready for you to review and mark ready.

Four stations, one line

Each station is a declared subagent with its own instructions, sandbox, and tools, and returns a structured result the next one builds on.

Classifier

Triages the work item and decides what counts as trivial, so the orchestrator never guesses.

Analyst

Plans against a live checkout of your repository, ending in testable acceptance criteria.

Implementer

Executes the plan in its own sandbox, verifies with your repo's own checks, and pushes a branch.

Reviewer

Independently judges every acceptance criterion against the real diff, with evidence for each verdict.

Work arrives from wherever it lives

Six surfaces feed the same pipeline.

Label an issue

onIssue

Add the factory label and the pipeline runs unattended, ending in a draft PR.

@mention Foreman

onComment

Mention Foreman on an issue or PR to start an attended session.

Delegate in Linear

onAgentSession

Assign Foreman a Linear issue and it reports back as Agent Activities.

Red CI on PRs

onCheckSuite

Foreman diagnoses failed checks on its own PRs and pushes a fix.

PR summaries

onPullRequest

Every newly opened PR gets one orienting comment for reviewers.

Dev TUI

pnpm dev

Hand Foreman a work item locally and approve each write yourself.

Nothing ships without you

Unattended runs stop at a draft pull request. Anything that ships waits for a person, and merging isn't in Foreman's tool surface at all.

factory-brain/<sha256(FACTORY_REPO)>.md
# Factory brain: your-org/your-repo
 
## Build
- Integration tests need the local Postgres from `pnpm db:up` first.
- `pnpm typecheck` is the slow one; lint and unit tests are cheap.
 
## Recurring review findings
- Server code assumes UTC; client bugs cluster around local-time math.
- New endpoints must register in `api/router.ts` or 404 in prod.

A factory that learns your repository

Foreman keeps durable notes on your repo, including build quirks, verification steps, and recurring review findings. It reads them at the start of every run, so the second run starts where the first left off.

Put agents on the assembly line

Read the docsDeploy now