LevitateOS

Documentation

rec* Tooling Overview

Repository-wide inventory of rec* tooling, with explicit status and boundaries.

Section

Context

The installer trio (recstrap, recfstab, recchroot) remains the primary manual install path. This section covers the broader rec* tool surface so the docs reflect the real repository.

WARNING

Status matters: not all tools here are equally mature. Each page calls out whether the tool is stable, beta, experimental, scaffold, or draft.

Section

Tool Matrix

Ordered canonically by tool name.

Tool Surface Primary Use Status
recab CLI A/B slot state machine Scaffold
recart CLI Artifact-store management Experimental
recchroot CLI Chroot with bind mounts Stable (installer)
recfstab CLI Generate fstab entries Stable (installer)
recguard Spec (no binary yet) Mutability policy verification Draft
recinit CLI + library Initramfs builder Experimental
reciso CLI + library UEFI ISO builder Beta
recpart CLI + backend Disk plan/apply backend Experimental
recqemu Library QEMU command/process helpers Beta (library-only)
recstrap CLI Extract installed rootfs Stable (installer)
recuki CLI + library Unified Kernel Image builder Beta

Section

Boundaries

  • Installer-facing: recstrap, recfstab, recchroot
  • Partition backend: recpart (plan/apply and handoff only)
  • Build pipeline: recinit, recuki, reciso
  • Infra/automation: recqemu, recart
  • A/B and policy control-plane: recab, recguard

Section

See Also