Skip to content

Latest commit

 

History

History
98 lines (64 loc) · 3.89 KB

README.md

File metadata and controls

98 lines (64 loc) · 3.89 KB
Raw

fish-exa

✅ Requirements

🚀 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