Describe the rest of the bins

bin/omarchy-battery-present

@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# Returns true if a battery is present on the system.
+# Used by the battery monitor and other battery-related checks.
+
 for bat in /sys/class/power_supply/BAT*; do
   [[ -r "$bat/present" ]] &&
   [[ "$(cat "$bat/present")" == "1" ]] &&

bin/omarchy-remove-dev-env

@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# Remove a development environment that was previously installed via omarchy-install-dev-env.
+# Usage: omarchy-remove-dev-env <ruby|node|bun|deno|go|php|laravel|symfony|python|elixir|phoenix|zig|rust|java|dotnet|ocaml|clojure>
+
 if [[ -z "$1" ]]; then
   echo "Usage: omarchy-remove-dev-env <ruby|node|bun|deno|go|php|laravel|symfony|python|elixir|phoenix|zig|rust|java|dotnet|ocaml|clojure>" >&2
   exit 1

bin/omarchy-reset-sudo

@@ -1,4 +1,7 @@
 #!/bin/bash
 
+# Reset the sudo lockout/faillock for the current user.
+# This clears any failed authentication attempts that may have locked the user out.
+
 # Resetting sudo lockout for user
 su -c "faillock --reset --user $USER"

bin/omarchy-restart-app

@@ -1,4 +1,7 @@
 #!/bin/bash
 
+# Restart an application by killing it and relaunching via uwsm.
+# Usage: omarchy-restart-app <application-name>
+
 pkill -x $1
 setsid uwsm-app -- $1 >/dev/null 2>&1 &

bin/omarchy-restart-bluetooth

@@ -1,5 +1,7 @@
 #!/bin/bash
 
+# Unblock and restart the bluetooth service.
+
 echo -e "Unblocking bluetooth...\n"
 rfkill unblock bluetooth
 rfkill list bluetooth

bin/omarchy-restart-hypridle

@@ -1,3 +1,5 @@
 #!/bin/bash
 
+# Restart the hypridle service (used for idle detection and auto-lock).
+
 omarchy-restart-app hypridle

bin/omarchy-restart-hyprsunset

@@ -1,3 +1,5 @@
 #!/bin/bash
 
+# Restart the hyprsunset service (used for blue light filtering/night light).
+
 omarchy-restart-app hyprsunset

bin/omarchy-restart-pipewire

@@ -1,4 +1,6 @@
 #!/bin/bash
 
+# Restart the PipeWire audio service to fix audio issues or apply new configuration.
+
 echo -e "Restarting pipewire audio service...\n"
 systemctl --user restart pipewire.service

bin/omarchy-restart-wifi

@@ -1,5 +1,7 @@
 #!/bin/bash
 
+# Unblock and restart the Wi-Fi service.
+
 echo -e "Unblocking wifi...\n"
 rfkill unblock wifi
 rfkill list wifi

bin/omarchy-restart-xcompose

@@ -1,3 +1,5 @@
 #!/bin/bash
 
+# Restart the XCompose input method service (fcitx5) to apply new compose key settings.
+
 omarchy-restart-app fcitx5

bin/omarchy-show-done

@@ -1,4 +1,7 @@
 #!/bin/bash
 
+# Display a "Done!" message with a spinner and wait for user to press any key.
+# Used by various install scripts to indicate completion.
+
 echo
 gum spin --spinner "globe" --title "Done! Press any key to close..." -- bash -c 'read -n 1 -s'

bin/omarchy-show-logo

@@ -1,5 +1,8 @@
 #!/bin/bash
 
+# Display the Omarchy logo in the terminal using green color.
+# Used by various presentation scripts to show branding.
+
 clear
 echo -e "\033[32m"
 cat <~/.local/share/omarchy/logo.txt

bin/omarchy-state

@@ -1,5 +1,9 @@
 #!/bin/bash
 
+# Manage persistent state files for Omarchy toggles and settings.
+# Usage: omarchy-state <set|clear> <state-name-or-pattern>
+# Used to track whether features like suspend, idle lock, etc are enabled or disabled.
+
 STATE_DIR="$HOME/.local/state/omarchy"
 mkdir -p "$STATE_DIR"