📦 Usage

Package repositories

For all the available packages use GitHub search.

Package Name	Description
any-node	The any Node module(s) locally in a newly created plugin directory.
any-gem	The any Gem(s) locally in a newly created plugin directory.
apr	The Apache Portable Runtime (APR) library.
fzf	The fzf command-line fuzzy finder.
fzy	The fzy command-line fuzzy finder.
pyenv	The pyenv Python virtual environment manager.
remark	The remark Markdown processor.
doctoc	The doctoc Markdown processor.
ls_colors	The LS_COLORS and setup a zsh-completion system color scheme.
dircolors-material	The dircolors-material and set up a zsh-completion system color scheme.
asciidoctor	The asciidoctor Markdown processor.
system-completions	Moves the stock Zsh completions under the control of Zi.
brew-completions	The Homebrew Shell Completion under the control of Zsh & Zi.
ecs-cli	The AWS ECS CLI.
subversion	The Subversion client.
github-issues	The GitHub Issues client.
github-issues-srv	The GitHub Issues server.
firefox-dev	The Firefox Developer Edition.
zsh	The Zsh mirror of zsh-users.
nb	Bookmarking, and archiving with linking, tagging, search, Git syncing, Pandoc conversion, and more.
zsh-bin	Package of statically-linked, hermetic, relocatable - romkatv/zsh-bin.

Package profiles

Apache Portable Runtime (APR) library

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	✅ (default)	❌	✅	❌	❌

Download, build and install the latest Apache Portable Runtime.

zi pack for apr

asciidoctor Markdown processor

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	❌	❌	❌	❌	✅ (default)

Download the Gem of asciidoctor locally with the bin-gem-node annex.

Using the @ prefix because of collision with the as'' ice.

zi pack for @asciidoctor

AWS ECS CLI

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	❌	✅ (default)	❌	❌	❌

Default

Download the binary of the Amazon-ECS-CLI command.

zi pack for ecs-cli

Annex

Download the ECS-CLI binary with the use of the bin-gem-node annex.

zi pack"bgn" for ecs-cli

dircolors-material color scheme

Package source	Tarball	Binary	Git	Node	Gem
Status:	❌	❌	✅ (default)	❌	❌

Default

Download the default profile.

zi pack for dircolors-material

No completion

Download the "no-zsh-completion" profile.

zi pack"no-zsh-completion" for dircolors-material

No color swap

Download the "no-color-swaps" profile.

zi pack"no-color-swaps" for dircolors-material

Minimal

Download the minimal profile without altering the original theme.

zi pack"minimal" for dircolors-material

doctoc Markdown processor

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	❌	❌	❌	✅ (default)	❌

A download default profile with the Node package of doctoc.

zi pack for doctoc

Firefox Developer Edition

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	❌	✅ (default)	❌	❌	❌

Default

Download the firefox-dev latest binary.

zi pack for firefox-dev

Annex

Download the firefox-dev latest binary with use of the bin-gem-node annex.

zi pack"bgn" for firefox-dev

fzf command-line fuzzy finder

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	✅ (default)	✅	✅	❌	❌

Default

Download the package with the default profile.

zi pack for fzf

Key bindings

Download the package with the default profile + key bindings.

zi pack"default+keys" for fzf

Annex

Download the package with the bin-gem-node annex.

zi pack"bgn" for fzf

Annex + key bindings

Download the package with the bin-gem-node annex and with the key bindings.

The "+keys" variants are available for each profile.

zi pack"bgn+keys" for fzf

Annex + git

Download with the bin-gem-node annex from GitHub repository.

zi pack"bgn" git for fzf

Binary

Download the binary from the GitHub releases.

zi pack"binary" for fzf

Annex + binary

Download the binary from the GitHub releases and install using bin-gem-node + shims.

zi pack"bgn-binary" for fzf

fzy command-line fuzzy finder

Package source:	Tarball	Binary	Git	Node	Gem
Status:	✅ (default)	❌	✅	❌	❌

Default

Download the package with the default profile.

zi pack for fzy

Annex

Download the package with the bin-gem-node annex.

zi pack"bgn" for fzy

Annex + git

Download with the bin-gem-node annex from GitHub repository.

zi pack"bgn" git for fzy

Default Override

Download normal ice list and override atclone'' ice to skip the contrib scripts

zi pack"bgn" atclone'' for fzy

LS_COLORS color scheme

Package source:	Tarball	Git	Node	Gem
Status:	🚫	✅ (default)	❌	❌

Default

Download the default profile.

zi pack for ls_colors

No completion

Download the "no-zsh-completion" profile.

zi pack"no-zsh-completion" for ls_colors

No color swap

Download the "no-dir-color-swap" profile.

zi pack"no-dir-color-swap" for ls_colors

Feature-rich note‑taking (nb)

Package source:	Source Tarball	Git	Node	Gem
Status:	✅ (default)	🚫	❌	❌

Default profile are using bin-gem-node to set shims.

zi pack for nb

Python virtual environment manager - pyenv

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	✅ (default)	❌	✅	❌	❌

Default

Download the tarball with the default ice list.

zi pack for pyenv

Annex

Download the binary from the GitHub releases with the bin-gem-node annex.

zi pack"bgn" for pyenv

Annex + git

Download with the bin-gem-node annex from GitHub repository.

zi pack"bgn" git for pyenv

remark Markdown processor

Package source:	Tarball	Git	Node	Gem
Status:	🚫	🚫	✅ (default)	❌

Default

Download the Node package of remark-CLI, remark-man and remark-HTML

zi pack for remark

Man only

Download the Node package of remark-CLI and remark-man

zi pack"man-only" for remark

HTML only

Download the Node package of remark-CLI and remark-HTML

zi pack"html-only" for remark

Subversion

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	✅ (default)	❌	✅	❌	❌

Download, build and install the latest Subversion.

Dependency of Subversion: APR

zi pack for subversion

Zsh mirror of zsh-users

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	❌	❌	✅ (default)	❌	❌

Default

Install the newest Zsh.

zi pack for zsh

Specific version

Install preferred Zsh version.

zi pack"5.9" for zsh
zi pack"5.8.1" for zsh
zi pack"5.8" for zsh
zi pack"5.7.1" for zsh
zi pack"5.6.2" for zsh
zi pack"5.5.1" for zsh
zi pack"5.4.2" for zsh
zi pack"5.3.1" for zsh
zi pack"5.2.4" for zsh
zi pack"5.1.1" for zsh

Statically-linked, hermetic, relocatable Zsh

Package source:	Source Tarball	Binary	Git	Node	Gem
Status:	❌	❌	✅ (default)	❌	❌

Default

Requires root access to install Zsh at /usr/local and will attempt to register it as a login shell.

zi pack for zsh-bin

Annex

Does not require root access, when install using bin-gem-node to set shims.

zi pack"bgn" for zsh-bin

Rootless

Does not require root access, will install to ~/.local.

zi pack"rootless" for zsh-bin