| name | repo-structure |
| description | Cached knowledge of the nucleus repository architecture, key files, module purposes, and DSC file semantics. Use when working in the nucleus repo to avoid re-discovering foundational structure every session. |
Nucleus Repository Structure
Top-level layout
src/flake.nix — Nix flake entry point. Imports host configs (src/hosts/*/) and shared modules (src/modules/). Defines nixosConfigurations, darwinConfigurations, home-manager configs, and nucleus-* app packages.src/hosts/ — per-machine configs: MacBook/ (macOS + nix-darwin), NixOS/ (Linux), Windows/ (WinGet DSC YAML + PowerShell apply).src/modules/ — shared Nix modules used across hosts. List src/modules/*.nix for the current set.src/scripts/ — shell scripts called by Nix activation or nucleus-* apps.scripts/ — user-facing automation helpers with paired .sh/.ps1 entry points.tests/ — Nix logic tests + Windows Pester DSC validation.
Key shared modules (src/modules/)
| Category | Modules |
|---|
| Base system | core.nix, posix-base.nix, posix-security.nix, posix-sops.nix, posix-user-shell.nix |
| OS-specific | macos.nix, linux.nix |
| User environment | home.nix, shell.nix, pwsh.nix, starship.nix, iterm2.nix |
| Developer tools | dev-repos.nix, editors.nix, git.nix |
| Security & secrets | gnupg.nix, secrets.nix |
| Services | https-proxy.nix, camillagui-backend.nix, ext-discord-music-rpc.nix, logging.nix |
| Files & media | cloud-drives.nix, fonts.nix, wallpapers.nix |
| AI agents | agents.nix, agent-env-vars.nix, agent-host-shell.nix |
| Env var catalog | lib/env-catalog.nix (catalog + resolution), lib/managed-paths.nix (PATH components) |
| Other | custom-provision-symlinks.nix |
Note: services.json in src/modules/ is a data file (service registry), not a Nix module. Host-specific modules (ntfs-3g.nix, camilladsp.nix, jellyfin.nix) live under their host directory.
Hosts
macOS (src/hosts/MacBook/)
default.nix — nix-darwin entry. Imports modules, defines services, system defaults.defaults.nix — macOS defaults write settings (NSGlobalDomain, dock, Finder, etc.).activation.nix — nix-darwin activation hooks (Spotlight disable, login items, shell profile).services.nix — macOS Services (.app bundles for right-click menus). Self-pruning via home.activation. Relies on macos/daemon-refresh.nix.homebrew.nix — Homebrew packages and taps.cloud-drives.nix — Cloud drive mount NFS paths.ai.nix, sops.nix, security.nix, networking.nix, camilladsp.nix, camillagui-backend.nix, jellyfin.nix, https-proxy.nix, service-watchdog.nix, vms.nix — host-specific configs.
NixOS (src/hosts/NixOS/)
default.nix — NixOS entry. Imports modules, defines boot, networking, services.services.nix — NixOS systemd services.desktop.nix — Desktop environment config.hardware/ — Hardware-specific configs.ai.nix, sops.nix, security.nix, networking.nix, camilladsp.nix, camillagui-backend.nix, jellyfin.nix, https-proxy.nix, vms.nix — host-specific configs.
Windows (src/hosts/Windows/)
apply.ps1 — orchestration entry point. Dot-sources modules/*.ps1, applies WinGet DSC YAML.modules/ — reusable PowerShell logic (Sync-, Invoke- functions, Format-NucleusOutput).system/*.dsc.yml — DSC configs applied system-wide.user/*.dsc.yml — Per-user DSC configs listed in users.json.
DSC architecture
| Category | Scope | Directory |
|---|
| System | Always applied to all users | system/*.dsc.yml |
| User | Per-user via dscConfigFiles in users.json | user/*.dsc.yml |
List the respective directories for the current set of DSC files.
