Installation

June 24, 2025 ยท View on GitHub

Packages

SystemPackage
Alpine Linuxzsh-autosuggestions
Debian / Ubuntuzsh-autosuggestions OBS repository
Fedora / CentOS / RHEL / Scientific Linuxzsh-autosuggestions OBS repository
OpenSUSE / SLEzsh-autosuggestions OBS repository
Arch Linux / Manjaro / Antergos / Hyperbolazsh-autosuggestions, zsh-autosuggestions-git
NixOSzsh-autosuggestions
Void Linuxzsh-autosuggestions
Mac OShomebrew
NetBSDpkgsrc
FreeBSDpkg

Antigen

  1. Add the following to your .zshrc:

    antigen bundle zsh-users/zsh-autosuggestions
    
  2. Start a new terminal session.

Oh My Zsh

  1. Clone this repository into $ZSH_CUSTOM/plugins (by default ~/.oh-my-zsh/custom/plugins)

    git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
    
  2. Add the plugin to the list of plugins for Oh My Zsh to load (inside ~/.zshrc):

    plugins=( 
        # other plugins...
        zsh-autosuggestions
    )
    
  3. Start a new terminal session.

Homebrew

  1. Install command:

    brew install zsh-autosuggestions
    
  2. To activate the autosuggestions, add the following at the end of your .zshrc:

    source $(brew --prefix)/share/zsh-autosuggestions/zsh-autosuggestions.zsh
    
  3. Start a new terminal session.

Manual (Git Clone)

  1. Clone this repository somewhere on your machine. This guide will assume ~/.zsh/zsh-autosuggestions.

    git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/zsh-autosuggestions
    
  2. Add the following to your .zshrc:

    source ~/.zsh/zsh-autosuggestions/zsh-autosuggestions.zsh
    
  3. Start a new terminal session.