borgmatic/docs/reference/command-line/autocompletion/bash.md

title, eleventyNavigation

title	eleventyNavigation
bash	key parent bash ➡️ Autocompletion

borgmatic includes an autocompletion script for Bash to support tab-completing command-line actions and flags. Depending on how you installed borgmatic, this may be enabled by default.

If completions aren't enabled, start by installing the bash-completion Linux package or the bash-completion@2 macOS Homebrew formula. Then, install the shell completion script globally:

sudo su -c "borgmatic --bash-completion > $(pkg-config --variable=completionsdir bash-completion)/borgmatic"

If you don't have pkg-config installed, you can try the following path instead:

sudo su -c "borgmatic --bash-completion > /usr/share/bash-completion/completions/borgmatic"

Or, if you'd like to install the script for only the current user:

mkdir --parents ~/.local/share/bash-completion/completions
borgmatic --bash-completion > ~/.local/share/bash-completion/completions/borgmatic

Finally, restart your shell (exit and open a new shell) so the completions take effect.