os-template

The clean origin of every agent-os instance: a repo-native, LLM-agnostic, rule-based operating system for AI coding agents. Machinery and the default constitution only - zero accounts, zero secrets, zero company data by construction (the cleanliness meta-rule proves it on every gate).

• NEW HERE: read onboarding.md - the layered guided install, from a bare machine (any OS) to a born, green instance: what you will need and when, every command with its expected output, a fast path for operators who know their way
• Bare machine: run bootstrap.sh (Linux/macOS) or bootstrap.ps1 (Windows) with the instance's git URL - it installs git + mise, clones, installs the pinned toolchain, and runs just setup, whose doctor walks everything else (Docker, secrets) to a green gate
• Reference execution tier - OPTIONAL for a green gate; everything above runs natively in your own shell (PowerShell on Windows). The devcontainer (.devcontainer/) is the identical Linux container on any host OS. WHEN: any time after just setup, once just doctor shows Docker green (Windows: WSL2 then Docker Desktop - the doctor names both install commands). HOW: open the repo in VS Code with the Dev Containers extension and run "Dev Containers: Reopen in Container" - the first build takes a few minutes, then the integrated terminal is bash inside Ubuntu with the pinned toolchain ready; closing the window returns you to your native shell
• just doctor any time: checks every prerequisite in order and names the exact per-OS cure for anything still missing
• Birth an instance: python system/template/init_instance.py --company <slug> --out <dir>
• Update an instance from here: just os-update (inside the instance) - updates land as a gated three-way diff from the instance's recorded template version; a red gate rolls back, and instances may decline
• The whole gate: just check (fixtures, compiled-context verification, registry, gateway, cleanliness, self-checks)