nixos-config

Create and update NixOS systemd service scripts within Nix modules. Use when adding, modifying, or debugging systemd services defined in NixOS module config blocks. Covers service structure, store path conventions, environment variables, timer services, tmpfiles, and troubleshooting.

Create and manage NixOS and home-manager modules following the enable-by-option pattern used in ShizNix. Use when adding new system functionality, refactoring existing modules, creating home-manager modules, adding systemd services, or working with option declarations. Covers module structure, option types, mkIf guards, systemd services, Stylix integration, cross-module dependencies, and verification.

Manage Nix flake operations — update inputs, lock flake, check evaluation, and maintain flake.nix. Use when updating flake dependencies, troubleshooting lock conflicts, adding/removing inputs, or running flake checks. Integrates with the nix-flake and nix-build tools.

Manage encrypted secrets with sops-nix and age encryption. Use when adding new secrets, rotating keys, editing encrypted values, or troubleshooting decryption failures. Covers sops-nix module integration, secrets.yaml structure, host key management, and decryption troubleshooting.

Debug NixOS build and evaluation failures. Use when nixos-rebuild fails, nix flake check errors, or module evaluation produces tracebacks. Covers common error patterns, trace analysis, and targeted fix strategies for the ShizNix configuration.