Persist aliases and other configuration in Fish Shell

Note to self: whenever making aliases in Fish (or any other config!), add them to the ~/.config/fish/config.fish file.

So they will be persisted after a system reboot.

Fish reads that file every time a new shell session starts. Anything you define there, like aliases, environment variables, or PATH changes, is recreated in every new terminal window.

Why aliases disappear

If you type an alias directly in the terminal, it works right away:

alias ls "exa"

But it only lives in that session. Close the terminal, and the alias is gone. That’s what kept biting me: I’d define the same aliases over and over and wonder why they vanished.

The fix is to put them in the config file. Open it:

nano ~/.config/fish/config.fish

And add the aliases there:

alias ls "exa"
alias cat "bat"

For example I set ls to be an alias of exa and cat to be an alias of bat:

Reloading the configuration

Editing config.fish does not affect terminals that are already open. Either open a new tab, or reload the file in the current session:

source ~/.config/fish/config.fish

An alternative: alias —save

Fish has a shortcut. Pass the -s (save) flag when you define the alias:

alias -s cat "bat"

Under the hood fish aliases are functions, and this saves the function to ~/.config/fish/functions/, where fish autoloads it in every future session. No need to touch config.fish at all.

Both approaches work. I prefer keeping everything in config.fish, because all my aliases sit in one file I can read, copy to a new machine, or put under version control.

Other configuration

The same rule applies to environment variables. Set them in config.fish with set -gx, so they’re global and exported to programs you run:

set -gx EDITOR nano

There’s also a fish-specific option: universal variables, created with set -U:

set -U EDITOR nano

Fish persists universal variables on its own, no config file needed. They survive reboots and are shared across all your fish sessions. Handy for one-off settings, but I still keep the ones I care about in config.fish, where I can see them.

Related posts about cli: