Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

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.