Page tree


This is a guide for updating to Z Shell on macOS.


From Wikipedia:

Zsh is an extended Bourne shell with many improvements, including some features of Bash, ksh, and tcsh.

Announced in June and released in October 2019, macOS Catalina has adopted Zsh as the default shell, replacing Bash.

Command not found

While it's optional to use Z shell if you choose to do so you might hit the following issue when starting a terminal:

/Users/rgange/.mgnl/mgnl:71: command not found: complete

Fix the issue

This issue exists on macOS Catalina which currently has issues with Java

Performing these steps will also work on Mojave even though it does not suffer from the issue. 

  1. From the command line, install nvm.

    curl -o- | bash
  2. Create a copy of your current .bash_profile to create .zprofile.
  3. In the file .zprofile, add the following code before: source ~/.mgnl/mgnl

    export NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/" ] && \. "$NVM_DIR/" # This loads nvm
    [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
    source ~/.mgnl/mgnl
  4. In the file .zshrc, add the following:

    autoload bashcompinit && bashcompinit
  5. Optional: Display the username, machine name and path at the prompt. In the file .zshrc, add the following:

    export PS1="%n@%m %d %% "
    Last login: Thu Jan  2 23:25:56 on ttys000
    rgange@florida /Users/rgange % 
  • No labels