README.md

March 22, 2026 · View on GitHub

Logo❮ Zsh eza ❯

Zsh plugin which replace GNU/ls with eza-community/eza

《❔》Ask a Question 《💡》Search Wiki 《💜》Join 《🌐》Localize

⭕ Trunk Check Visual Studio Code

Environment variables

VariableDescriptionDefault
_EZA_PARAMSeza params to be used('--git' '--group' '--group-directories-first' '--time-style=long-iso' '--color-scale=all' '--icons')
AUTOCDenable auto list directories on cd0

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.