cli doc improvements

bin/omarchy-brightness-display-apple

@@ -1,6 +1,8 @@
 #!/bin/bash
 
 # omarchy:summary=Adjust the brightness on Apple Studio Displays and Apple XDR Displays using asdcontrol.
+# omarchy:args=<+N%|N%-|N%>
+# omarchy:examples=omarchy brightness display apple +5% | omarchy brightness display apple 5%- | omarchy brightness display apple 50%
 
 if (( $# == 0 )); then
   echo "Adjust Apple Display brightness by passing +5%, 5%-, or 100%"

bin/omarchy-hyprland-monitor-scaling-cycle

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# omarchy:summary=Cycle scaling for the focused Hyprland monitor
+# omarchy:summary=Cycle focused Hyprland monitor scaling through 1x, 1.25x, 1.6x, 2x, and 3x
 
 MONITOR_INFO=$(hyprctl monitors -j | jq -r '.[] | select(.focused == true)')
 ACTIVE_MONITOR=$(echo "$MONITOR_INFO" | jq -r '.name')

bin/omarchy-swayosd-brightness

@@ -1,7 +1,8 @@
 #!/bin/bash
 
 # omarchy:summary=Display brightness level using SwayOSD on the current monitor.
-# omarchy:args=<percent>
+# omarchy:args=<0-100>
+# omarchy:examples=omarchy swayosd brightness 0 | omarchy swayosd brightness 50 | omarchy swayosd brightness 100
 
 percent="$1"
 

bin/omarchy-swayosd-kbd-brightness

@@ -1,7 +1,8 @@
 #!/bin/bash
 
 # omarchy:summary=Display keyboard brightness level using SwayOSD on the current monitor.
-# omarchy:args=<percent>
+# omarchy:args=<0-100>
+# omarchy:examples=omarchy swayosd kbd brightness 0 | omarchy swayosd kbd brightness 50 | omarchy swayosd kbd brightness 100
 
 percent="$1"