Мой .zshrc с использованием zinit

Как известно, все любители командной строки обожают перегруженные промпты с кучей ненужной информации, чтобы почувствовать себя L33T H4CK3rS. Пример установки самого выпендрёжного из них - powerlevel10k - есть в документации zinit. Я предпочитаю чуть более умеренную geometry. На её примере заодно и разберу основы синтаксиса zinit. Zinit в простом случае принимает в качестве координат плагина путь к репозиторию на github в формате <username>/<repo>. Другие источники, конечно же, тоже поддерживаются. Zinit сам скачивает репозиторий и следит за его обновлением.

zinit geometry-zsh/geometry

Теперь промпт должен смениться на минималистичный треугольник:

Кроме имени репозитория ещё принимается список модификаторов, которые так или иначе влияют на процесс загрузки плагина. Для того чтобы применить модификаторы есть два вида синтаксиса на выбор: легаси ice и новенький for. Два модификатора придётся лепить почти на все плагины - это lucid, который убирает спам отладочными сообщениями и light-mode, который выключает некоторые фичи zinit типа статистики использования плагина, чтобы грузиться как можно быстрее. Применю их, используя for синтаксис.

zinit lucid light-mode for \
  geometry-zsh/geometry

Fzf имеет небольшие тонкости в установке, поэтому в zinit есть специальная конструкция pack, которая позволяет переиспользовать скрипты установки популярных плагинов.

zinit pack"default+keys" for fzf

Для того, чтобы заработали сочетания клавиш ctrl+t для выбора файла из текущей директории и ctrl+r для интерактивного поиска по истории, нужно засурсить файл, находящийся по пути shell/key-bindings.zsh в репозитории fzf. В zinit отдельные файлы можны выбирать модификатором pick'<путь до zsh файла от корня>'.

zinit wait lucid for pick'shell/key-bindings.zsh' junegunn/fzf

Во многих туториалах, в том числе и в документации fzf, можно встретить ещё и предложение включить shell/completions.zsh чтобы использовать fzf для автокомплита. Однако для меня лучше подошёл плагин fzf-tab, который лучше интегрируется со стандартным автокомплитом из zshell.

zinit wait lucid has'fzf' for Aloxaf/fzf-tab

У меня много проектов, между которыми приходится часто переключаться. Поэтому я себе поставил плагин для избранных директорий zfm. По сочетанию ctrl+p открывается fzf с выбором моих избранных директорий.

zinit wait'0a' lucid light-mode for \
   pabloariasal/zfm

Иногда хочется иметь что-то вроде Cmd+Shift+A в Intellij или Command Palette в VS Code, чтобы забить “get first line of a file” и не вспоминать что там за команда head и какие у неё команды. Для этого существует navi - интерактивный cheatsheet. Ставится он чуть более сложно - нужно выполнить eval после загрузки скрипта. Это делается модификатором atload.

zinit wait lucid from"gh-r" as"null" for \
  atload'eval "$(navi widget zsh)"' \
                        denisidoro/navi

Теперь, нажав ctrl+g вы получите интерактивное окошко куда можно будет вбивать ваши хотелки и получать готовые сниппеты.

Наконец, для любителей погонять json-ы jq является незаменимой. Однако иногда хочется интерактивно пощупать json, попробовать разные запросы. Некто reegnz совместил fzf и jq и получилась очень приятная утилита, которая пайпит результат только что введённой команды в jq и позволяет фильтровать результат, да ещё и с автокомплитом полей. Чтобы заполучить эту красоту, достаточно пары строчек. Обрати внимание на trackbinds в сочетании с bindmap"\ej -> ^j". Эти модификаторы дают возможность переопределить биндинги, которые приносит плагин. Например, тут мне захотелось вызывать jq на ctrl+j.

zinit wait lucid light-mode trackbinds for \
  bindmap"\ej -> ^j" reegnz/jq-zsh-plugin

Самое простое - если completion лежит на гитхабе. Тогда всё что требуется - добавить модификатор as'completion'.

zinit wait lucid for \
 as"completion" gradle/gradle-completion

Хотя я и ругал OMZ за его раздутость, всё таки для некоторых программ там есть неплохие комплишены. Благо, zinit имеет специальный синтаксис для загрузки плагинов из репозитория OMZ.

zinit wait lucid for \
 as"completion" OMZP::docker/_docker

Иногда комплишен предлагают устанавливать из локального файла. Для этого в zinit есть специальный модификатор is-snippet.

zinit wait lucid for \
 as"completion" blockf is-snippet "$HOME/.dotfiles/zshell/func/_arc"

У zsh есть и свой джентельменский набор комплишенов, которым можно воспользоваться при помощи следующей команды.

zinit wait lucid for \
 atload"zicompinit; zicdreplay" blockf @zsh-users/zsh-completions

Здесь atload делает некоторую zsh магию, которую я не берусь обьяснять в этом посте. Просто копипастишь себе в конфиг и наслаждаешься.