Legacy fish support guide

[jorgebucaran]

Stuck in legacy fish <=2.2 and can't upgrade your shell? Got you covered. 💯

If you are running fish 2.0 you'll need source. So, create a new file source.fish and put it in your fish functions directory.

function source
    . $argv
end

If you are running fish 2.1 or 2.2 you can skip the previous step. Now, open your fish configuration file (~/.config/fish/config.fish) and add this code to the beginning of the file.

set -q XDG_CONFIG_HOME; or set XDG_CONFIG_HOME ~/.config
for file in $XDG_CONFIG_HOME/fish/conf.d/*.fish
    source $file 2>/dev/null
end

That will run configuration snippets manually on shell startup. See fish-shell/fish-shell#2498 to learn more about configuration snippets

That's it—happy fishing!

Notes

• Please consider upgrading to the latest fish.
• If XDG_CONFIG_HOME is defined on your system, use $XDG_CONFIG_HOME/fish/config.fish to access your fish configuration.