From 0e40b89be8aba05452c3e4d15f59c99161d8fba0 Mon Sep 17 00:00:00 2001
From: Aaron Fiore <founder@evergreencrypto.co>
Date: Wed, 25 Feb 2026 11:43:04 -0800
Subject: [PATCH 1/3] container: finance: lib_plugins: update usage help

---
 container/src/finance/lib/internal/lib_plugins.bash | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/container/src/finance/lib/internal/lib_plugins.bash b/container/src/finance/lib/internal/lib_plugins.bash
index 78a8357..9adae68 100644
--- a/container/src/finance/lib/internal/lib_plugins.bash
+++ b/container/src/finance/lib/internal/lib_plugins.bash
@@ -2,7 +2,7 @@
 
 # docker-finance | modern accounting for the power-user
 #
-# Copyright (C) 2024-2025 Aaron Fiore (Founder, Evergreen Crypto LLC)
+# Copyright (C) 2024-2026 Aaron Fiore (Founder, Evergreen Crypto LLC)
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -71,7 +71,7 @@ function lib_plugins::__parse_args()
 
 \e[32mUsage:\e[0m
 
-  $ $global_usage [help | [TAB COMPLETION]] [args]
+  $ $global_usage <help | [TAB COMPLETION]> [args]
 
 \e[32mArguments:\e[0m
 
@@ -91,8 +91,8 @@ function lib_plugins::__parse_args()
 
   \e[37;2m# The output of tab completion\e[0m
   $ $global_usage \\\t\\\t
-    custom/billing/invoice.bash   help                          repo/timew_to_timeclock.bash
-    custom/billing/manage.bash    repo/example.bash
+    custom/billing/invoice.bash   custom/example.bash           repo/example.bash
+    custom/billing/manage.bash    help                          repo/timew_to_timeclock.bash
 
   \e[37;2m# Execute a repository shell plugin in '${_repo}'\e[0m
   $ $global_usage repo${global_arg_delim_1}example.bash \"I'm in repo\"

From 17692e61fc2e11bf2ab312e7d243f3ebe6e63eae Mon Sep 17 00:00:00 2001
From: Aaron Fiore <founder@evergreencrypto.co>
Date: Wed, 25 Feb 2026 11:44:28 -0800
Subject: [PATCH 2/3] client: docker: lib_plugins: update usage help

---
 .../src/docker/lib/internal/lib_plugins.bash  | 26 ++++++++++++++++---
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/client/src/docker/lib/internal/lib_plugins.bash b/client/src/docker/lib/internal/lib_plugins.bash
index f6ad51b..00b30bd 100644
--- a/client/src/docker/lib/internal/lib_plugins.bash
+++ b/client/src/docker/lib/internal/lib_plugins.bash
@@ -2,7 +2,7 @@
 
 # docker-finance | modern accounting for the power-user
 #
-# Copyright (C) 2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+# Copyright (C) 2024,2026 Aaron Fiore (Founder, Evergreen Crypto LLC)
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -71,14 +71,32 @@ function lib_plugins::__parse_args()
 
 \e[32mUsage:\e[0m
 
-  $ $global_usage <repo${global_arg_delim_1}plugin | custom${global_arg_delim_1}plugin> [args]
+  $ $global_usage <help | [TAB COMPLETION]> [args]
+
+\e[32mArguments:\e[0m
+
+  [None | help]: show this usage help
+
+  [TAB COMPLETION]: run given shell plugin
+
+    custom = custom plugins in custom plugin location
+    repo   = repository plugins in repository location
+
+  [args]: arguments to plugin
 
 \e[32mExamples:\e[0m
 
-  \e[37;2m# Execute a repository plugin in '${_repo}'\e[0m
+  \e[37;2m# See this usage help\e[0m
+  $ $global_usage help
+
+  \e[37;2m# The output of tab completion\e[0m
+  $ $global_usage \\\t\\\t
+    custom/example.bash  help                 repo/bitcoin.bash    repo/example.bash    repo/tor.bash
+
+  \e[37;2m# Execute a repository shell plugin in '${_repo}'\e[0m
   $ $global_usage repo${global_arg_delim_1}example.bash \"I'm in repo\"
 
-  \e[37;2m# Execute a custom plugin in '${_custom}'\e[0m
+  \e[37;2m# Execute a custom shell plugin in '${_custom}'\e[0m
   $ $global_usage custom${global_arg_delim_1}example.bash \"I'm in custom\"
 "
 

From 12d9d31d2ff171076019ef9f36eb960c08f352be Mon Sep 17 00:00:00 2001
From: Aaron Fiore <founder@evergreencrypto.co>
Date: Thu, 26 Feb 2026 10:36:49 -0800
Subject: [PATCH 3/3] client: docker: completion: add help to `plugins`

---
 client/src/docker/completion.bash | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/client/src/docker/completion.bash b/client/src/docker/completion.bash
index e054c45..95b6965 100644
--- a/client/src/docker/completion.bash
+++ b/client/src/docker/completion.bash
@@ -2,7 +2,7 @@
 
 # docker-finance | modern accounting for the power-user
 #
-# Copyright (C) 2024-2025 Aaron Fiore (Founder, Evergreen Crypto LLC)
+# Copyright (C) 2024-2026 Aaron Fiore (Founder, Evergreen Crypto LLC)
 #
 # This program is free software: you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -131,7 +131,7 @@ function docker-finance::completion()
             find "${DOCKER_FINANCE_CLIENT_REPO}"/client/plugins/docker "${_args[@]}" -printf 'repo/%P\n' 2>/dev/null
           })
           declare -r _plugins
-          mapfile -t _reply < <(compgen -W "${_plugins[*]}" -- "$_cur")
+          mapfile -t _reply < <(compgen -W "help ${_plugins[*]}" -- "$_cur")
           ;;
       esac
       declare -r _reply