bash-completion adds completion for:
- Command names after
- Macports and Homebrew package names (optional)
- Hostnames in
known_hosts for commands like
- Folders on
And so on. You can print a list of completion commands with
complete -p and see the source of a function with
Installing Homebrew or MacPorts and Bash
First, you have to install Homebrew or MacPorts according to the instructions. Note: Do not install both, as they conflict.
Then, install a newer version of Bash. The built-in Bash in OS X is a little old, and you'll get more completion options with Bash > 4.1, which you can get through
brew install bash
sudo port install bash
depending on whether you use Homebrew or MacPorts.
Installing bash-completion with Homebrew
bash-completion, you have to:
brew install bash-completion
And add the following to your
if [ -f $(brew --prefix)/etc/bash_completion ]; then
. $(brew --prefix)/etc/bash_completion
Homebrew currently installs an older version of bash-completion (1.3) that still works with Bash 3.x, but still, using Bash 4.x is recommended.
Installing bash-completion with MacPorts
sudo port install bash-completion
Then, add to your
if [ -f /opt/local/etc/profile.d/bash_completion.sh ]; then
See trac.macports.org/wiki/howto/bash-completion for instructions on how to enable completion for port names.