DEV Community

Cover image for ⚙️ ❮ ZI Console ❯
❮ ZI ❯ for Z-Shell

Posted on • Updated on • Originally published at z-shell.pages.dev

⚙️ ❮ ZI Console ❯

❮ ZI ❯ Console > For CLI Ninjas


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


A console for ZI – based on the zsh/zcurses Zshell module allows the user to:

  • View the currently loaded plugins in a colorful list, in one of 3 different display modes,
  • Unload and load plugins,
  • Delete the plugins and snippets from the disk.

Usage

Start the console by Ctrl-O Ctrl-J keyboard shortcut, or by running ziconsole function in the shell.

Then, in the console:

Key(s) Description
Ctrl-U,Ctrl-D Half page up; half page down
Ctrl-P,Ctrl-N Previous line, centered; next line, centered
Ctrl-L Redraw of whole display
[, ] Jump to next and previous section (e.g.: next plugin or snippet)
g, G Jump to beginning and end of whole interface
<,> or {,} Horizontal scroll (i.e.: left or right)
/ Show incremental search
F1 Jump to result (in incremental search) and back
Esc Exit incremental search, clearing query
Ctrl-W Delete whole word (in incremental search)
Ctrl-K Delete whole line (in incremental search)

Screencast

asciicast

Install console

Load like any other normal plugin, e.g.:

with use of Turbo mode and the for-syntax:

zi wait lucid for z-shell/zi-console
Enter fullscreen mode Exit fullscreen mode

The plugin needs zsh/curses Zsh module. You can check if it's available to your Zsh by executing:

zmodload zsh/curses
Enter fullscreen mode Exit fullscreen mode

If the call will return an error, then the zsh/curses module isn't available.

Solving The Lack Of zsh/curses Module With ZI

You can build the zsh/curses-equipped Zshell with ZI by the following command:

zi ice id-as"zsh" atclone"./.preconfig
        CFLAGS='-I/usr/include -I/usr/local/include -g -O2 -Wall' \
        LDFLAGS='-L/usr/lib -L/usr/local/lib' ./configure --prefix='$ZPFX'" \
    atpull"%atclone" run-atpull make"install" pick"/dev/null"
zi load zsh-users/zsh
Enter fullscreen mode Exit fullscreen mode

The command will build a custom zsh and install it under $ZPFX (~/.zi/polaris by default). The path $ZPFX/bin is already added to $PATH by ZI at first position, so starting zsh will run the new Zshell.

When on Gentoo, and possibly other systems, the zsh can still not have the ncurses library linked. To address this, utilize the z-a-patch-dl annex and automatically patch the source first:

zi light z-shell/z-a-patch-dl
zi ice id-as"zsh" atclone"./.preconfig
        CFLAGS='-I/usr/include -I/usr/local/include -g -O2 -Wall' \
        LDFLAGS='-L/usr/lib -L/usr/local/lib' ./configure --prefix='$ZPFX'" \
    dl"https://gist.githubusercontent.com/z-shell/2373494c71cb6d1529344a2ed1a64b03/raw -> curses.patch" \
    patch'curses.patch' atpull"%atclone" reset \
    run-atpull make"install" pick"/dev/null"
zi load zsh-users/zsh
Enter fullscreen mode Exit fullscreen mode

Then, to update, rebuild and reinstall the zsh, you can do zi update zsh. The binary can be safely copied over /bin/zsh as it has paths to all needed directories built-in.

Top comments (0)