- Fisher 4.0+
Install using Fisher:
fisher install plttn/fish-eza| alias | default options |
|---|---|
l | eza |
ll | eza --group --header --group-directories-first --long |
ll in git repo | eza --group --header --group-directories-first --long --git |
lg | eza --group --header --group-directories-first --long --git --git-ignore |
le | eza --group --header --group-directories-first --long --extended |
lt | eza --group --header --group-directories-first --tree --level LEVEL |
lc | eza --group --header --group-directories-first --across |
lo | eza --group --header --group-directories-first --oneline |
Each base alias has its extended versions with additional options.
An extended alias is one of the form <BASE ALIAS><SUFFIX> with suffix from the following:
| Extend suffix | Default options |
|---|---|
a | --all --binary |
d | --only-dirs |
i | --icons |
id | --icons --only-dirs |
aa | --all --binary --all |
ad | --all --binary --only-dirs |
ai | --all --binary --icons |
aid | --all --binary --icons --only-dirs |
aad | --all --binary --all --only-dirs |
aai | --all --binary --all --icons |
aaid | --all --binary --all --icons --only-dirs |
Any of these suffixes appended to any previous base alias is a valid alias too (eg: ll + a => lla).
ezamples:
la => --all --binary -------a------ llad => --all --binary --only-dirs --group --header --group-directories-first --long ------------ad------------ -----------------------ll------------------------ ltaa => --all --binary --all --group --header --group-directories-first --tree --level LEVEL ---------aa--------- ------------------------------lt--------------------------------Extended options are always prepended to base aliases options.
Eza has --git options displaying git status of each file in a dedicated column (when using the long view).
When inside a git repo, the --git option will be automatically added to every alias beginning with ll (as --git only works with --long) (lla, llaa, llid etc).
Configuration is done through environment variables.
To avoid spamming your config.fish, you can set environment variables using set -Ux once, to make them persistent across restarts and share them across fish's instances.
set -Ux EZA_STANDARD_OPTIONS --long --all
EZA_STANDARD_OPTIONS
default eza options used in all aliases except l
default : --group --header --group-directories-first
You can define per alias options using an env variable named EZA_<ALIAS>_OPTIONS.
For ezample, to customize ll specific options, you would store them in EZA_LL_OPTIONS
Extended suffixes have their env variable as well : EZA_<SUFFIX>_OPTIONS.