Shell completion is available on bash, zsh, and fish. It allows you to press TAB to see available options, suggested arguments, flags, and help information. It will also show remote paths, local backups, and ongoing download IDs when appropriate. It is strongly recommended when using a supported shell.

When jotta-cli updates, it might come with new completions, so it is recommended to update the completions with jotta-cli.

MacOS

On MacOS you need to install homebrew and then use brew to install bash-completion and then add bash completion to your shell. You might also have to upgrade bash as MacOS ships with a fairly old version and this affects bash-completion scripts.
​

First, install homebrew from https://brew.sh/ You probably already have this if you installed jotta-cli on MacOS.
​

Second, check your bash version:

If your bash major version is less than 4 you need to upgrade:

Now you need to whitelist the new bash version by adding it to the list of shells found in the file /etc/shells
​
After whitelisting the shell ensure you are running the new version by running

More information on upgrading bash is available here: https://itnext.io/upgrading-bash-on-macos-7138bd1066ba?gi=a0e70050c3ff
​
​
Third, install bash-completion:

and remember to follow the instructions about how to add bash-completion to your shell typically something like below:

Fourth, add the following to your ~/.bash_profile:

​Linux

Many linux distros come with bash-completion already loaded. If not you can run

or the non-debian equivalent.

Then, add the following to your ~/.bash_profile or ~/.bashrc :

If shell completion is not already enabled in your environment, you will need to enable it. You can do this by executing the following once:

echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions for each session, execute once:

You will need to start a new shell for this setup to take effect.

To load completions for the current session, execute:

To load completions for each session, execute (once):