---
name: nix
description: NixOS package management and dotfiles configuration. Activates for package install/remove/search, system updates, and configuration changes.
---

# NixOS Package Management

Help with NixOS configuration and package management.

**User input:** $ARGUMENTS

## Instructions

1. **Read context and config:**
   - Read `~/Dotfiles/CLAUDE.md` to understand the dotfiles layout
   - Read `~/Dotfiles/configuration.nix` to see current packages
   - Read `~/Dotfiles/flake.nix` if flake changes needed

2. **Parse the request:**
   - **Install package:** User wants to add a package (e.g., "install htop", "add nodejs")
   - **Remove package:** User wants to remove a package
   - **Search:** User wants to find a package (e.g., "search for video editor")
   - **Update:** User wants to update the system
   - **Other:** Configuration changes, services, etc.

3. **For package install/remove:**
   - Search nixpkgs to confirm exact package name: `nix search nixpkgs <name>`
   - Edit `configuration.nix` to add/remove from `users.users.sasha.packages`
   - Show the diff to user

4. **For search:**
   - Run `nix search nixpkgs <query>` and summarize results
   - Suggest the most relevant package(s)

5. **For updates:**
   - Run `nix flake update` in `~/Dotfiles`
   - Then rebuild

6. **Apply changes:**
   - Run: `nrs` (alias for nixos-rebuild switch)
   - If rebuild fails:
     - Analyze the error output
     - Identify the root cause (missing dependency, syntax error, etc.)
     - Fix the issue and retry
     - Repeat until successful or user asks to stop
   - Report success

7. **Update documentation:**
   - If structural changes were made (new services, major packages), update `~/Dotfiles/CLAUDE.md`

8. **Commit changes (only after successful rebuild):**
   - `cd ~/Dotfiles`
   - `git add -A`
   - `git commit` with a descriptive message (e.g., "Add htop package", "Update flake inputs")
   - Ask user: "Ready to push to remote?"
   - Only push if user confirms

## Package Locations

- **User packages:** `configuration.nix` → `users.users.sasha.packages`
- **System packages:** `configuration.nix` → `environment.systemPackages`
- **Flake inputs:** `flake.nix` → for adding external flakes