Foreman polls your issue tracker, breaks tickets into granular tasks, writes code with LLM-guided TDD, runs deterministic quality checks, and opens pull requests — autonomously.

Requirements: Go 1.25+ and a C toolchain (CGO is required for SQLite).

make build
cp foreman.example.toml foreman.toml
# Edit foreman.toml — set your tracker, LLM provider, and git tokens
./foreman doctor   # verify config
./foreman start    # start the daemon

Or with Docker Compose:

docker compose up --build

See docs/getting-started.md for a full walkthrough including environment variables, first-run checks, and generating an AGENTS.md for your repo.

MIT (LICENSE)