README.md
March 22, 2026 · View on GitHub
|
|
|
|
Environment variables
| Variable | Description | Default |
|---|---|---|
| _EZA_PARAMS | eza params to be used | ('--git' '--group' '--group-directories-first' '--time-style=long-iso' '--color-scale=all' '--icons') |
| AUTOCD | enable auto list directories on cd | 0 |
Aliases
alias ls='eza $eza_params'
alias l='eza --git-ignore $eza_params'
alias ll='eza --all --header --long $eza_params'
alias llm='eza --all --header --long --sort=modified $eza_params'
alias la='eza -lbhHigUmuSa'
alias lx='eza -lbhHigUmuSa@'
alias lt='eza --tree $eza_params'
alias tree='eza --tree $eza_params'
Install
The eza should be present to use this plugin. Install eza with Zi:
zi ice from'gh' as'program' sbin'**/eza -> eza' atclone'CARGO_HOME=$ZPFX cargo install --path . && cp -vf completions/eza.zsh _eza'
zi light eza-community/eza
With Zi
To install add to the .zshrc file:
zi light z-shell/zsh-eza
Install only if eza exists and enable auto list directories:
zi ice has'eza' atinit'AUTOCD=1'
zi light z-shell/zsh-eza
Install only if eza exists and enable auto list directories in turbo mode:
zi ice wait lucid has'eza' atinit'AUTOCD=1'
zi light z-shell/zsh-eza
Install only if eza exists and enable auto list directories in turbo mode with the for syntax:
zi wait lucid for \
has'eza' atinit'AUTOCD=1' \
z-shell/zsh-eza
With Oh My Zsh
Clone the repository and add zsh-eza to the plugins array of your zshrc file:
~/.oh-my-zsh/custom/plugins
plugins=(... zsh-eza)
With Zplug
Add zplug z-shell/zsh-eza to your ~/.zshrc and re-open your terminal session.
With Antigen
Add to your .zshrc file:
antigen bundle z-shell/zsh-eza@main
Note: The @main branch suffix is required because this repository uses main as the default branch, while Antigen defaults to master.