Add a new seq-command module

hosts/nixos/home-default.nix

@@ -15,6 +15,7 @@
     ../../modules/dictionary.nix
     ../../modules/claude-code.nix
     ../../modules/fonts.nix
+    ../../modules/seq-command.nix
   ];
 
   home.username = "yanlin";

modules/seq-command.nix

@@ -0,0 +1,68 @@
+{ pkgs, ... }:
+
+let
+  seqCommandScript = pkgs.writeShellScriptBin "seq-command" ''
+    gap=0
+    service=false
+    file=""
+
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --gap)
+          gap="$2"
+          shift 2
+          ;;
+        --service)
+          service=true
+          shift
+          ;;
+        *)
+          file="$1"
+          shift
+          ;;
+      esac
+    done
+
+    if [[ -z "$file" || "$gap" -eq 0 ]]; then
+      echo "seq-command - Execute commands from a file sequentially with gaps"
+      echo ""
+      echo "Usage: seq-command --gap <minutes> [--service] <commands-file>"
+      echo ""
+      echo "Options:"
+      echo "  --gap <minutes>  Wait time between command executions"
+      echo "  --service        Run as a background systemd user service"
+      echo ""
+      echo "The commands file is treated as a FIFO queue - each line is removed after execution."
+      exit 1
+    fi
+
+    file="$(realpath "$file")"
+
+    if [[ ! -f "$file" ]]; then
+      echo "File not found: $file"
+      exit 1
+    fi
+
+    if $service; then
+      exec systemd-run --user --unit="seq-command-$(date +%s)" seq-command --gap "$gap" "$file"
+    fi
+
+    gap_seconds=$((gap * 60))
+
+    while [[ -s "$file" ]]; do
+      cmd="$(head -n 1 "$file")"
+      tail -n +2 "$file" > "$file.tmp" && mv "$file.tmp" "$file"
+
+      if [[ -n "$cmd" ]]; then
+        eval "$cmd"
+      fi
+
+      if [[ -s "$file" ]]; then
+        sleep "$gap_seconds"
+      fi
+    done
+  '';
+in
+{
+  home.packages = [ seqCommandScript ];
+}