fish-eza

✅ Requirements

• Fisher 4.0+

🚀 Install

Install using Fisher:

fisher install gzheng92/fish-eza

🔧 Usage

Base aliases

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

Extended aliases

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).

Examples:

  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.

Auto detect git repository

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

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.

⚠️ : Don't use quotes in variables, set them as a list: set -Ux EZA_STANDARD_OPTIONS --long --all

Default options

EZA_STANDARD_OPTIONS

default exa options used in all aliases except l

default : --group --header --group-directories-first

Aliases options

You can define per alias options using an env variable named EZA_<ALIAS>_OPTIONS.

For example, to customize ll specific options, you would store them in EZA_LL_OPTIONS

Extended suffixes have their env variable as well : EZA_<SUFFIX>_OPTIONS.

Moving from Exa to Eza

Now that Exa is deprecated, all the shell variables it set are just clutter. I removed them all using the following:

for var in $(printenv | grep ^EXA | cut -d= -f1); set --universal --erase $var; end

For a more complete solution, first uninstall fish-exa. Do this before installing fish-eza.

fisher remove $(fisher list fish-exa)

📝 License

MIT