fish-exa

✅ Requirements

• Fisher 4.0+

🚀 Install

Install using Fisher:

fisher install gazorby/fish-exa

🔧 Usage

Base aliases

alias	default options
l	exa
ll	exa --group --header --group-directories-first --long
ll in git repo	exa --group --header --group-directories-first --long --git
lg	exa --group --header --group-directories-first --long --git --git-ignore
le	exa --group --header --group-directories-first --long --extended
lt	exa --group --header --group-directories-first --tree --level LEVEL
lc	exa --group --header --group-directories-first --across
lo	exa --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

Exa 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 EXA_STANDARD_OPTIONS --long --all

Default options

EXA_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 EXA_<ALIAS>_OPTIONS.

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

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

📝 License

MIT