Overview
Nix-based configuration framework for managing a heterogeneous fleet of machines (Darwin and NixOS), optimized for AI agent deployment, remote development, and virtualized environments. Built on Clan.lol for cluster orchestration.
Machines
Section titled “Machines”See the full Inventory & Machines for details, services matrix, and current configuration (verified against modules/clan/machines.nix and services.nix).
Structure
Section titled “Structure”The repo follows the dendritic pattern: every .nix under import-tree roots is a flake-parts module. Feature modules export flake.modules.{nixos,darwin,hjem}.<feature>; machines are composed by the registry in modules/clan/.
See Inventory & Machines for details.
Documentation Sections
Section titled “Documentation Sections”- Inventory & Machines
- Architecture
- Operations (including boot, multiboot, remote desktop, moonlight troubleshooting, rollback, testing, migration)
- KWin Tiling — detailed section with its own features, usage, and roadmap (using fragments for GH #124 lists)
For source of truth, all docs here are verified against current sources in the repo (modules/, lib/, flake.nix, etc.).
The KWin tiling project has dedicated detailed coverage because it is a larger feature in the repo. It delivers Native KWin tiling with features like Interactive resize, patch split, and tracks open items such as Retile / reset, more layout engines, and smart/dynamic gaps.