diff options
Diffstat (limited to 'CLAUDE.md')
| -rw-r--r-- | CLAUDE.md | 10 |
1 files changed, 9 insertions, 1 deletions
@@ -8,6 +8,13 @@ This is a NixOS flake-based configuration managing three machines: desktop, lapt ## Common Commands +### Verify Changes (use this first) +```bash +dry-rebuild # Alias for: nix build ~/.config/nixos#nixosConfigurations.$(hostname).config.system.build.toplevel --no-link +``` + +**Always run `dry-rebuild` after making changes** to catch evaluation and build errors without needing sudo or activating the system. Claude Code cannot run `sudo`, so `dry-rebuild` is the required verification step. + ### Rebuild System ```bash rebuild # Alias for: sudo nixos-rebuild switch --flake ~/.config/nixos @@ -164,5 +171,6 @@ in 3. **User-level modules** contain pure home-manager configuration 4. **Hardware configuration files** are auto-generated - do not manually edit 5. **Use unstable overlay** when you need bleeding-edge versions of specific packages -6. **Test changes** with `nixos-rebuild switch` before committing +6. **Verify changes** with `dry-rebuild` before committing 7. **Format code** with nixfmt before committing +8. **Commit messages** should be a single short sentence — no body, no bullet points, no co-author line |