Additional completion definitions for Zsh.
Latest commit cd61ca5 Oct 19, 2016 @syohex syohex committed on GitHub Merge pull request #462 from arcizan/ripgrep
Add completion script for ripgrep


Additional completion definitions for Zsh.

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


See issues for details on each completion definition.

Gentoo's completions have been removed, as they are maintained upstream. See: Gentoo zsh-completions


Using packages

Using frameworks

  • If you're using antigen, just add antigen bundle zsh-users/zsh-completions to your .zshrc where you're loading your other zsh plugins.

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


If you use oh-my-zsh then just clone the repository inside your oh-my-zsh repo:

git clone ~/.oh-my-zsh/custom/plugins/zsh-completions

and enable it in your .zshrc by adding it to your plugin list and reloading the completion:

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


Contributions are welcome, just make sure you follow the guidelines:

  • Completions are not accepted when already available in zsh.
  • Completions are not accepted when already available in their original project.
  • Please do not just copy/paste someone else completion, ask before.
  • Completions only partially implemented are not accepted.
  • Please add a header containing authors, license info, status and origin of the script (example here).
  • Please try to follow Zsh completion style guide.
  • Please send one separate pull request per file.
  • Send a pull request or ask for committer access.


See each file for license details.