Understanding Workstation Config

The workstation monorepo organizes NixOS system configuration and home-manager user configuration into separate directories: hosts/ for system-level settings, users/ for user-specific configs, assets/ for shared resources, scripts/ for automation, and .claude/ for Claude-related metadata. This separation lets you navigate and modify configurations by role.

NixOS manages system-wide configuration stored in hosts/, while home-manager manages per-user environment and dotfiles in users/. Together they define both machine and user state in a single monorepo, enabling reproducible workstation setup across contributors.

Start by identifying the five core directories: hosts/ contains system configs per machine, users/ contains per-user profiles, assets/ holds shared files, scripts/ provides setup automation, and .claude/ stores devbox metadata. This layout lets you quickly locate what to modify for your workstation.

Yes. This skill provides a concise tour of the monorepo structure that new developers can request via plain language commands, reducing time spent searching for configuration files and understanding how system and user settings are organized.

Understand that hosts/ and users/ separate concerns: hosts/ defines machine-level packages and services, users/ defines shell environments and dotfiles. Knowing this distinction prevents confusion when editing configuration and helps you place changes in the correct directory.