From ee0be951e3174f39f2a549b3be0c5cc14e81b384 Mon Sep 17 00:00:00 2001
From: Jamie Albert <git.747@flatmail.me>
Date: Thu, 13 Nov 2025 20:53:43 +0000
Subject: [PATCH] add: help

---
 dotfiles/dao.sh/local/bin/dao.sh | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/dotfiles/dao.sh/local/bin/dao.sh b/dotfiles/dao.sh/local/bin/dao.sh
index 1c87380..bc22e5f 100755
--- a/dotfiles/dao.sh/local/bin/dao.sh
+++ b/dotfiles/dao.sh/local/bin/dao.sh
@@ -13,6 +13,33 @@
 # ---
 set -euo pipefail
 
+show_help() {
+	cat <<'EOF'
+Usage: dao.sh <COMMAND> [OPTIONS]
+
+A command dispatcher for various utilities and scripts.
+
+COMMANDS:
+	kitty [OPTIONS]							Manage Kitty terminal instances
+			--list									List current Kitty instances
+			--new-instance					Launch new Kitty instance
+			--new-tab								Launch new Kitty tab
+	mount [OPTIONS]							Mount filesystems
+	pwgen [OPTIONS]							Generate secure passwords
+	update											Update system packages
+
+EXAMPLES:
+	dao update									Run system update
+	dao mount --unmount					Unmount filesystems
+	dao kitty --list						List Kitty instances
+	dao kitty --new-tab					Launch Kitty or new tab
+
+Use 'dao <COMMAND> --help' for command-specific help.
+EOF
+exit 0
+}
+
+[[ "${1:-}" == "-h" || "${1:-}" == "--help" ]] && show_help
 # ---
 # shellcheck disable=1091
 # ---