Hai-os

hai-os (display name: HaiOS) is the fleet's machine-agnostic bootstrap system for Omarchy (Arch Linux + Hyprland). Boot the USB, run one script, and Claude Code walks you through the rest interactively.

Stack: Shell + Nix + Hyprland. Private repo.

Setup

Boot from the Ventoy USB, install Omarchy, connect to network, then:

/mnt/usb/hai-os/setup.sh

setup.sh installs Claude Code, copies itself to ~/hai-os, and launches Claude with full context. Claude asks for machine role, detects hardware (GPU, monitors, disks), fills in configuration, installs packages, sets up dotfiles, and asks for interactive logins (GitHub, 1Password) as needed.

Roles

desktop — Full Hyprland desktop, GPU, container runtime, all apps.
laptop — Hyprland desktop, container runtime, GPU if present.
server — Headless, container runtime, optional GPU.
sentinel — Lightweight Hyprland desktop, NVIDIA GPU, Nix.

hai-os provisions base OS + desktop + GPU + container runtime only. Cluster join (RKE2) is a separate manual layer that lives in cloud/gems, not here.

Editions (rice)

A role is what a machine does; an edition is how it looks. Editions are pure, reversible desktop rice on top of the base + role.

gem — Crystal Mom's Cove: fleet desktop rice, warm cream on deep near-black, one accent colour per unit (from $HAI_OS_ACCENT). Procedural 4K wallpaper, a3d.rs-rendered faceted-diamond fastfetch logo, accent window border, per-node starship prompt, optional spinning gem-spin diamond. Deploy: scripts/deploy-gem-theme.sh.
cluster — Snoop's Cluster: per-node rice for the GPU cluster; one near-black battlefield where each node wears its pixel-art mech (canonical fastfetch sprite) + that mech's accent.
hai — bundled stock theme, cyber-blue palette + half-block ANSI fastfetch slab. Selectable via omarchy-theme-set hai; auto-activated if THEME=hai in config/vars.env.

Sources

README
overlay/themes/README.md — edition framework.

Setup

Roles

Editions (rice)

Sources

See also