added helper script

flake.nix

@@ -82,6 +82,7 @@
           uv-bin = pkgs.callPackage ./packages/uv { };
           lanshare = pkgs.callPackage ./packages/lanshare { };
           warpssh = pkgs.callPackage ./packages/warpssh { };
+          whst = pkgs.callPackage ./packages/whst { };
         };
       formatter.x86_64-linux = nixpkgs.legacyPackages.x86_64-linux.nixfmt-rfc-style;
       hydraJobs = {

homeManagerModules/packages/development.nix

@@ -33,6 +33,7 @@ in
       rpi-imager
       wireguard-tools
       warpssh
+      whst
     ];
     programs.go = {
       enable = true;

overlays/default.nix

@@ -8,6 +8,7 @@ in
       uv-bin = self.packages.x86_64-linux.uv-bin;
       lanshare = self.packages.x86_64-linux.lanshare;
       warpssh = self.packages.x86_64-linux.warpssh;
+      whst = self.packages.x86_64-linux.whst;
       kropcloud-utils = inputs.kropcloud-utils.packages.x86_64-linux.default;
       gamescope = prev.gamescope.overrideAttrs (oldAttrs: {
         patches = (oldAttrs.patches or [ ]) ++ [

packages/whst/default.nix

@@ -0,0 +1,67 @@
+{
+  writeShellScriptBin,
+}:
+writeShellScriptBin "whst" ''
+  print_help () {
+    cat << EOF
+  Usage: whst <status_code> [options]
+
+  Check the meaning or details of a given HTTP status code.
+
+  Arguments:
+    status_code    Integer HTTP status code to look up (e.g., 200, 404).
+
+  Options:
+    -h             Show this help message and exit.
+
+  Examples:
+    whst 200
+    whst 404 -h
+
+  EOF
+  }
+
+  OPTSTRING="h"
+
+  while getopts "$OPTSTRING" opt; do
+    case "$opt" in
+      h)
+        print_help
+        exit 0
+        ;;
+      ?)
+        echo "Invalid option: -$OPTARG." >&2
+        exit 1
+        ;;
+    esac
+  done
+
+  shift $((OPTIND - 1))
+
+  if (( $# < 1 )); then
+    echo "Error: Missing required status_code argument." >&2
+    echo "Use -h for help." >&2
+    exit 1
+  fi
+
+  status_code="$1"
+
+  if ! [[ "$status_code" =~ ^[0-9]+$ ]]; then
+    echo "Error: status_code must be an integer." >&2
+    exit 1
+  fi
+
+  url="https://http.cat/$status_code"
+
+  xdg-open "$url" >/dev/null 2>&1
+
+  ret=$?
+
+  if (( ret != 0 )); then
+    echo "Failed to open browser automatically. Here's the URL instead:"
+    echo "$url"
+    exit 1
+  fi
+
+  exit 0
+''