Foreman is a server-owned, hosted-first software delivery control plane. It keeps humans in control while agents plan, implement, and deliver work with durable tasks, packets, runs, deliveries, and event history.
This repository contains the current Foreman system: the hosted proxy, the local node runtime, the desktop client, and shared runtime support.
Important
Preview status: this repository is public for visibility and reference while Foreman is still under active development. It is not yet intended for general use or adoption, and rough edges, missing workflows, and changing contracts should be expected.
foreman-proxy/hosts the public-edge runtime for auth, webhook ingress, relay, and hosted deployment concerns.foreman-server/is the local node runtime and system of record for workflow state.foreman-desktop/contains the desktop shell and Tauri application that stays thin over the documented transports.foreman-runtime-support/provides shared runtime environment and tooling helpers.docs/contains repo-level contributor and architecture guidance.
docs/README.mdfor the repo-level documentation index and contributor-facing guidance.foreman-server/README.mdfor local node setup, validation, and package behavior.foreman-proxy/README.mdfor the hosted proxy's responsibilities and deployment notes.foreman-desktop/README.mdfor desktop setup and development.AGENTS.mdfor contributor and agent execution rules in this repository.