Skip to content
Go to file

zsh-completions GitHub release GitHub contributors IRC Gitter

Additional completion definitions for Zsh.

This projects aims at gathering/developing new completion scripts that are not available in Zsh yet. The scripts may be contributed to the Zsh project when stable enough.


Using packages

System Package
Debian / Ubuntu zsh-completions OBS repository
Fedora / CentOS / RHEL / Scientific Linux zsh-completions OBS repository
OpenSUSE / SLE zsh-completions OBS repository
Arch Linux / Manjaro / Antergos / Hyperbola zsh-completions, zsh-completions-git
Gentoo / Funtoo app-shells/zsh-completions
NixOS zsh-completions
Void Linux zsh-completions
Slackware Slackbuilds
macOS homebrew, MacPorts
NetBSD pkgsrc
FreeBSD shells/zsh-completions

Using zsh frameworks


Add antigen bundle zsh-users/zsh-completions to your ~/.zshrc.


  • Clone the repository inside your oh-my-zsh repo:

      git clone ${ZSH_CUSTOM:=~/.oh-my-zsh/custom}/plugins/zsh-completions
  • Enable it in your .zshrc by adding it to your plugin list and reloading the completion:

      plugins=(… zsh-completions)
      autoload -U compinit && compinit

Manual installation

  • Clone the repository:

      git clone git://
  • Include the directory in your $fpath, for example by adding in ~/.zshrc:

      fpath=(path/to/zsh-completions/src $fpath)
  • You may have to force rebuild zcompdump:

      rm -f ~/.zcompdump; compinit


Contributions are welcome, see CONTRIBUTING.


Completions use the Zsh license, unless explicitly mentioned in the file header. See LICENSE for more information.

You can’t perform that action at this time.