Replace nrb/ndr shell functions with 'just' command wrappers and update documentation

Author: izaac

AGENTS.md

@@ -122,16 +122,23 @@ The Chief maintains a separate repository for personal packages at `~/nix-packag
 
 ```bash
 # Rebuild and switch (preferred)
-nh os switch .             # or use the 'nrb' shell function
+just build                 # or use the 'nrb' shell function
 
-# Dry-run rebuild
-nh os switch . -- --dry-run
+# Dry-run build
+just dry-build             # or use the 'ndr' shell function
+
+# Build the Travel-Canoe (ISO)
+just iso
+
+# Ghost Cave (VM with Disko)
+just vm
 
 # Update flake inputs
-nix flake update
+just up                    # or use the 'up' shell function
 
-# Format (alejandra via pre-commit and flake check)
+# Format (alejandra via pre-commit and nix flake check)
 nix flake check
+```
 
 # Lint Nix (also run automatically by pre-commit hooks)
 statix check .

home/shell.nix

@@ -402,12 +402,12 @@ in {
                 return 127
               }
 
-              # Stage dotfiles (used by nrb/ndr/up functions)
+              # Stage dotfiles (used by build/up functions)
               st() { git -C "${userConfig.dotfilesDir}" add .; }
-              nrb() { st && nh os switch; }
-              ndr() { st && nh os build; }
-              up() { st && nh os switch --update; }
-              up-browsers() { st && nix flake update nixpkgs && nh os switch; }
+              nrb() { st && just build; }
+              ndr() { st && just dry-build; }
+              up() { st && just up; }
+              up-browsers() { st && just up-browsers; }
 
               [[ -z "$CLEAN_PATH" ]] && readonly CLEAN_PATH='${cleanPath}'
               [[ -z "$COPILOT_BIN" ]] && readonly COPILOT_BIN='${copilotBin}'

justfile

@@ -31,6 +31,11 @@ up:
 	nix flake update
 	nh os switch . --update
 
+# Update only browser inputs and switch
+up-browsers:
+	nix flake update nixpkgs
+	nh os switch .
+
 # Deploy Ninja brain to a remote IP via SSH (WIPES DISK!)
 deploy-ninja ip:
 	nix run github:nix-community/nixos-anywhere -- --flake .#ninja root@{{ip}}