About this book

What it is

A system-wide description of BenixOS, the distributed operating system built from Kits over the Hearth protocol. It covers the design, what exists today, and what is still open.

What it is not

Scope and method

Written from the project's design notes, the Kit registry, and a read of the public Hearth spec and the executor and distribution repositories. Nothing was built or run to write it. Test counts and exit-test results are the repositories' own claims. Each chapter opens with a State box that says what is built and what is not.

Label Means
Built Code exists and is tested; the page names the evidence
Partial Something real exists, but a stated part does not
Draft A written design with no code behind it
Planned Named in a plan; no design and no code

Kit statuses use the registry's words: design, scaffold, alpha, pre-release, stable, legacy, banked. No Kit is stable today.

Status

Written on 15 November 2026. Most of the code described is unpublished, and parts of it change daily. Where a page and a repository disagree, the repository is right.

AI assistance

Parts of this repository were designed, written and tested with AI tools. A person reviews what is merged and is responsible for it.

Licence

The text is licensed under Creative Commons Attribution 4.0 International. The build tooling is licensed under Apache-2.0. See LICENSE-docs and LICENSE.

Corrections

Open an issue or a pull request on the repository.