added documentation for nix scripts

docs/scripts/commands.md

@@ -0,0 +1,49 @@
+# pagedMov's Custom Command Scripts
+
+## icanhazip
+	- Leverages ip and icanhazip.com to return relevant ip info for the current machine.
+	- Usage:
+		- `icanhazip` - returns public ip, local ip, and default gateway
+		- `icanhazip -p` - returns only public ip
+		- `icanhazip -l` - returns only local ip
+		- `icanhazip -d` - returns only default gateway
+	- Defined in 'modules/home/scripts/commands/icanhazip.nix'
+
+## invoke
+	- Leverages `nix run` to run any command once. Works with arguments.
+	- Usage:
+		- `invoke <command>`
+	- Example:
+		- `invoke hello`
+	- Defined in 'modules/home/scripts/commands/invoke.nix'
+
+## runbg
+	- Runs a command and detaches the process from the shell silently. Works with arguments. Credit to [Frost-Phoenix](https://github.com/Frost-Phoenix) for writing this script.
+	- Usage:
+		- `runbg <command> <args>`
+	- Example:
+		- `runbg waybar`
+	- Defined in 'modules/home/scripts/commands/runbg.nix'
+
+## toolbelt
+	- Opens a fuzzyfinder window with some useful utilities. Meant to be used with the Super + P bind defined in hyprland.nix, and not invoked directly from the shell.
+	- Defined in 'modules/home/scripts/commands/toolbelt.nix'
+
+## viconf
+	- Searches the directory held in the $FLAKEPATH environment variable for a given nix file or directory name. Opens the file found in neovim, or if there are multiple matches, opens a fuzzyfinder window to allow you to choose one.
+	- Usage:
+		- `viconf <part of path or filename>`
+	- Examples:
+		- `viconf hyprland` - Opens $FLAKEPATH/modules/home/environment/hyprland.nix
+		- `viconf sys` - Opens fuzzyfinder window containing all nix files in modules/sys and its subdirectories
+		- `viconf config` - Opens fuzzyfinder window containing all nix files called 'config.nix'
+		- `viconf scripts/def` - Opens $FLAKEPATH/modules/home/scripts/default.nix
+	- Defined in 'modules/home/scripts/commands/viconf.nix'
+
+## vipkg
+	- Searches the pkgs directory from the nixpkgs github repository. Works almost identically to viconf with a few tweaks to accomodate the different directory structure. Useful for when you want to override a package's build attributes. Can also just be used to search for a package name.
+	- Usage:
+		- `vipkg <part of package name>`
+	- Example:
+		- `vipkg neofetch` - Opens nixpkgs/pkgs/tools/misc/neofetch/default.nix
+	- Defined in 'modules/home/scripts/commands/vipkg.nix'

docs/scripts/nixshortcuts.md

@@ -0,0 +1,36 @@
+# pagedMov's Nix Aliases
+
+## fetchfromgh
+	- Given a username and repo name like someuser/somerepo, generates a full pkgs.fetchFromGitHub call.
+	- Usage:
+		- `fetchfromgh someuser/somerepo`
+	- Example:
+		- `fetchfromgh pagedMov/nixos-config` - returns this:
+			src = pkgs.fetchFromGitHub {
+				owner = "pagedMov";
+				repo = "nixos-config";
+				rev = "fcf19c65971c667f67abf57bcaf88be410fb0759";
+				hash = "sha256-z+3E+ueSd2QNqtrbBKt8bwIfboPCXSUrGn690Hc/kl0=";
+			};
+	- Defined in 'modules/home/scripts/nix/fetchfromgh.nix'
+
+## garbage-collect
+	- Runs the Nix garbage collector and also deletes all files in .local/share/Trash
+	- Usage:
+		- `garbage-collect` - Does not take any arguments
+	- Defined in 'modules/home/scripts/nix/garbage-collect.nix'
+
+## nsp
+	- Simple alias for `nix-shell -p`
+	- Usage:
+		- `nsp <package name>`
+	- Example:
+		- `nsp hello`
+	- Defined in 'modules/home/scripts/nix/nsp.nix'
+
+## rebuild
+	- nh os switch and nh home switch packaged into one command
+	- Usage:
+		- `rebuild -h` - Runs `nh home switch -c <currenthostname> $FLAKEPATH`
+		- `rebuild -s` - Runs `nh os switch -H <currenthostname> $FLAKEPATH`
+	- Defined in 'modules/home/scripts/nix/rebuild.nix'