DEV Community

Cover image for ⚙️ ❮ ZZComplete ❯
Z-Shell profile image ❮ ZI ❯
❮ ZI ❯ for Z-Shell

Posted on • Edited on

⚙️ ❮ ZZComplete ❯

#zsh #tooling #productivity #shell


Logo

https://z.digitalclouds.dev | GitHub | Twitter

  • Please see related post as this is additional tool for ⬢ ZUI.

Asciinema preview

You can resize the video like a normal web page, i.e.: with Ctrl/Cmd+plus and Ctrl/Cmd+minus.

asciicast

Motivation

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 ZZ Complete, 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.

Installation

Dependencies

The plugin needs also ZUI plugin and a Zsh that is built with the zsh/curses module.

Manual

Clone the Repository.

git clone https://github.com/z-shell/zzcomplete ~/path/to/zzcomplete
Enter fullscreen mode Exit fullscreen mode

And add the following to your zshrc file.

source ~/path/to/zzcomplete/zzcomplete.plugin.zsh
Enter fullscreen mode Exit fullscreen mode

ZI

Add the following to your zshrc file.

zi light z-shell/zzcomplete
Enter fullscreen mode Exit fullscreen mode

Antigen

Add the following to your zshrc file.

antigen bundle z-shell/zzcomplete
Enter fullscreen mode Exit fullscreen mode

Zgen

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

zgen load z-shell/zzcomplete
Enter fullscreen mode Exit fullscreen mode

Oh-My-Zsh

Clone the Repository.

git clone https://github.com/z-shell/zzcomplete.git \
  ~ZSH_CUSTOM/plugins/zzcomplete
Enter fullscreen mode Exit fullscreen mode

And add zzcomplete to your plugin list.

Top comments (0)