From b0b95d2b2af2d06b276d551deeee19b39af9e8c0 Mon Sep 17 00:00:00 2001
From: "George L. Yermulnik" <yz@yz.kiev.ua>
Date: Fri, 12 Jun 2026 14:39:25 +0300
Subject: [PATCH] feat(bash_completion): Append user-defined aliases (if any)
 to the list of commands

Please refer to #22352 for details
---
 Library/Homebrew/completions/bash.erb | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Library/Homebrew/completions/bash.erb b/Library/Homebrew/completions/bash.erb
index b1d942329496a..1207583a18fa5 100644
--- a/Library/Homebrew/completions/bash.erb
+++ b/Library/Homebrew/completions/bash.erb
@@ -113,6 +113,7 @@ __brew_complete_commands() {
 
   local cur="${COMP_WORDS[COMP_CWORD]}"
   local cmds
+  local -a cmds_user_aliases
   local maintainer_cmds
 
   if [[ -n ${__HOMEBREW_COMMANDS} ]]
@@ -129,6 +130,15 @@ __brew_complete_commands() {
   then
     maintainer_cmds="<%= maintainer_commands.join(" ") %>"
   fi
+
+  # Append user-defined aliases (if any) to the list of commands
+  # Please refer to https://github.com/Homebrew/brew/pull/22352 for details
+  while read -r cmds_user_alias
+  do
+    cmds_user_aliases+=("${cmds_user_alias}")
+  done < <(compgen -W "$(__brew_list_aliases)")
+  [[ -n ${cmd_aliases[*]+"${cmd_aliases[*]}"} ]] && cmds+=" ${cmds_user_aliases[*]}"
+
   while read -r line
   do
     [[ $(__brew_internal_command_alias "${line}") == "${line}" ]] || continue
@@ -159,6 +169,7 @@ __brew_internal_command_alias() {
 }
 
 # https://github.com/Homebrew/homebrew-aliases
+# Please refer to https://github.com/Homebrew/brew/pull/22352 for details
 __brew_list_aliases() {
   local aliases_dir="${HOME}/.brew-aliases"
   local pattern="^# alias: brew ([[:alnum:]-]+)$"