Sanatana-Linux

Work with Cairo surfaces, custom widget drawing, and theme asset generation in this AwesomeWM config. Use when creating painted surfaces, custom widget :draw() methods, gradient backgrounds, icon recoloring, shape functions, or cropping/transforming images.

Add and maintain keyboard shortcuts in the AwesomeWM config at /etc/nixos/external/awesome. Use when adding a new keybinding, modifying an existing one, or debugging dual-bind/keyd throttle issues.

Create AwesomeWM popup components with this codebase's singleton, gobject, and OSD patterns. Use when adding a popup, wiring mutual-exclusion, or implementing control panel applets.

Create or modify AwesomeWM system service modules (audio, battery, network, bluetooth, etc.) following codebase conventions. Use when building a new service, refactoring an existing one, or debugging service patterns.

Test AwesomeWM config changes using Xephyr nested sessions. Use when testing configuration changes, debugging runtime errors, or validating syntax before reloading.

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.