⚙️ ZZComplete

z-shell/zzcomplete

Complete options from manual pages – press Ctrl-F to start the completer.

The completion of options has drawbacks:

1. The user has to remember a part of the option he wants to complete.
2. OR he is forced to read through all the options (listed after TAB).

With ZZComplete, the user can:

1. Search in the manual for arbitrary text related to the option.
2. Then select the option that's located nearby the found text.
3. Also, the user can read about the possible values of the options and select them too.

ZZComplete preview

Install ZZComplete

Prerequisites: ZUI library and a Zsh that is built with the zsh/curses module.

Zi

Add the following to your .zshrc file.

~/.zshrc

zi light z-shell/zzcomplete

Zgen

Add the following to your .zshrc file in the same place you're doing your other zgen load calls in.

~/.zshrc

zgen load z-shell/zzcomplete

Oh-My-Zsh

Clone the Repository.

~/.zshrc

git clone https://github.com/z-shell/zzcomplete.git \
  ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zzcomplete

And add zzcomplete to your plugin list.

Standalone

Clone the Repository.

git clone https://github.com/z-shell/zzcomplete \
  ~/some/path/to/zzcomplete

And add the following to your .zshrc file.

~/.zshrc

source ~/path/to/zzcomplete/zzcomplete.plugin.zsh