1 files changed, 73 insertions, 0 deletions
diff --git a/config/hypr/scripts/LuaCycleWindow.sh b/config/hypr/scripts/LuaCycleWindow.sh
new file mode 100755
index 00000000..ee64e67a
--- /dev/null
+++ b/config/hypr/scripts/LuaCycleWindow.sh
@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# ==================================================
+#  KoolDots (2026)
+#  Project URL: https://github.com/LinuxBeginnings
+#  License: GNU GPLv3
+#  SPDX-License-Identifier: GPL-3.0-or-later
+# ==================================================
+# Cycle focus through visible windows on the active workspace using the
+# Hyprland Lua dispatcher API. This avoids cyclenext/focuswindow no-ops on
+# Lua config builds.
+
+set -u
+
+direction="${1:-next}"
+case "$direction" in
+  next|forward|f)
+    direction="next"
+    ;;
+  previous|prev|back|b)
+    direction="previous"
+    ;;
+  *)
+    exit 0
+    ;;
+esac
+
+active_window="$(hyprctl activewindow -j 2>/dev/null || printf '{}')"
+active_address="$(jq -r '.address // empty' <<<"$active_window")"
+active_workspace="$(jq -r '.workspace.id // empty' <<<"$active_window")"
+
+if [[ -z "$active_address" ]] || ! [[ "$active_workspace" =~ ^-?[0-9]+$ ]]; then
+  exit 0
+fi
+
+clients="$(hyprctl clients -j 2>/dev/null || printf '[]')"
+target_address="$(
+  jq -r \
+    --arg active_address "$active_address" \
+    --argjson active_workspace "$active_workspace" \
+    --arg direction "$direction" '
+      [
+        .[]
+        | select((.mapped // false) == true)
+        | select((.hidden // false) == false)
+        | select(.workspace.id == $active_workspace)
+        | {
+            address,
+            x: (.at[0] // 0),
+            y: (.at[1] // 0)
+          }
+      ]
+      | sort_by(.y, .x, .address)
+      | if length < 2 then
+          empty
+        else
+          . as $windows
+          | ($windows | map(.address) | index($active_address)) as $index
+          | if $index == null then
+              empty
+            elif $direction == "previous" then
+              $windows[(($index - 1 + length) % length)].address
+            else
+              $windows[(($index + 1) % length)].address
+            end
+        end
+    ' <<<"$clients"
+)"
+
+if [[ -z "$target_address" ]]; then
+  exit 0
+fi
+
+hyprctl dispatch "hl.dsp.focus({ window = \"address:${target_address}\" })" >/dev/null 2>&1 || true