Crasis – semigraphical interface to Zplugin#

Zsh exposes its parser via (z) substitution flag. Parsing .zshrc is totally possible. This way Crasis lets you edit your Zplugin commands located in .zshrc. All in pure Zshell code.

No more commenting-out a line with a text editor to disable plugin, cluttering .zshrc, now you can just press a button.

asciicast

Crasis uses pure-Zshell ZUI library to create ncurses interface.

Installation & Basic Use#

Install Zplugin and add following commands to .zshrc:

zplugin light zdharma/zui
zplugin light zdharma/zplugin-crasis

To use, invoke crasis [optional zshrc path] or press Ctrl-o-k. Global variables CRASIS_THEME and CRASIS_LAYOUT can be used to override configuration file crasis.conf (located in plugin's tree), i.e.:

CRASIS_THEME="zdharma-256" CRASIS_LAYOUT="contract" crasis

256-color themes require Zsh 5.3 or later.

Key Bindings#

Key(s) Description
<,> or {,} Horizontal scroll (i.e. left or right)
Ctrl-L Redraw of whole display
Ctrl-U Half page up
Ctrl-D Half page down
Ctrl-P Previous line, centered
Ctrl-N Next line, centered
[, ] Jump to next and previous section (e.g. next plugin or snippet)
g, G Jump to beginning and end of whole interface
/ 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)
Up and down Resize text field when editing it (e.g. to make the text fit in)

Screenshots#

clean-256

zdharma-256

Code Documentation#

Crasis is a ZUI application. ZUI is a pure-Zshell library where user generates simple text with hyperlinks, which is then turned into active document with buttons. Check out Crasis code documentation: Asciidoc, PDF.