fish

If you decide to set fish as the default user shell, the first step is to set the shell of this particular user to /usr/bin/fish. This can be done by following the instructions in Command-line shell#Changing your default shell.

The next step is to port the current needed actions and configuration performed in the various Bash initialization scripts, namely /etc/profile, ~/.bash_profile, and , into the fish framework.

In particular, the content of the environment variable, once directly logged under fish, should be checked and adjusted to one's need. In fish, is defined as a global environment variable: it has a global scope across all functions, it is lost upon reboot and it is an environment variable which means it is exported to child processes. The recommended way of adding additional locations to the path is by calling the fish_add_path command from . For example:

$ fish_add_path -p /first/path /second/path /third/one

These three locations will be prepended to the path.

Not setting fish as system wide or user default allows the current Bash scripts to run on startup. It ensures the current user's environment variables are unchanged and are exported to fish which then runs as a Bash child. Below are several ways of running fish in interactive mode without setting it as the default shell.

Keep the default shell as Bash and simply add the line exec fish to the appropriate Bash#Configuration files, such as .bashrc. This will allow Bash to properly source /etc/profile and all files in . Because fish replaces the Bash process, exiting fish will also exit the terminal. Compared to the following options, this is the most universal solution, since it works both on a local machine and on a SSH server.

Another option is to open your terminal emulator with a command line option that executes fish. For most terminals this is the switch, so for example, to open gnome-terminal using fish, change your shortcut to use:

gnome-terminal -e fish

With terminal emulators that do not support setting the shell, for example , it would look like this:

SHELL=/usr/bin/fish lilyterm

Also, depending on the terminal, you may be able to set fish as the default shell in either the terminal configuration or the terminal profile.

To set fish as the shell started in tmux, put this into your :

set-option -g default-shell "/usr/bin/fish"

Whenever you run tmux, you will be dropped into fish.

The fish terminal colors, prompt, functions, variables, history, bindings and abbreviations can be set with the interactive web interface:

fish_config

It may fail to start if IPv6 has been disabled. See and IPv6#Disable IPv6.

fish can generate autocompletions from man pages. Completions are written to and can be generated by calling:

fish_update_completions

You can also define your own completions in ~/.config/fish/completions/. See /usr/share/fish/completions/ for a few examples.

Context-aware completions for Arch Linux-specific commands like pacman, pacman-key, makepkg, pbget, pacmatic are built into fish, since the policy of the fish development is to include all the existent completions in the upstream tarball. The memory management is clever enough to avoid any negative impact on resources.

fish does not implement Bash style history substitution (e.g. ), and the developers recommend in the fish faq to use the interactive history recall interface instead: the arrow recalls whole past lines and (or ) recalls individual arguments, while prepends to the existing line.

However some workarounds are described in the fish wiki: while not providing complete history substitution, some functions replace with the previous command or with the previous last argument.

By default, fish prints a greeting message at startup. To disable it, run once:

$ set -U fish_greeting

This clears the universal variable, shared with all fish instances and which is preserved upon restart of the shell.

If su starts with Bash because Bash is the target user's (root if no username is provided) default shell, one can define a function to redirect it to fish whatever the user's shell:

~/.config/fish/functions/su.fish

function su
   command su --shell=/usr/bin/fish $argv
end

Add the following to the bottom of your .

For those running fish in interactive mode, replace with status is-interactive in the above code.

If you would like fish to display the branch and dirty status when you are in a git directory, you can define the following function:

However, this is now deprecated, see fish-shell git. Alternatively, the Informative Git Prompt has now been built into fish and can be activated from fish_config if so desired.

To color the hostname in the prompt dynamically whenever connected through SSH, add the following lines in either the function or the fish configuration file, here using the red color:

In fish, generate errors due to how variables are set. To work around this, use the csh-style option :

$ eval (ssh-agent -c)

Fish includes a "command not found" hook that will automatically search the official repositories, when entering an unrecognized command. This hook will be run using , falling back to pacman -F if it is not installed.

Since 3.2.2, "command not found" will not fallback to pacman -F by default due to its bad performance.

If the delay this behavior introduces is undesirable, this hook can be overridden by redefining so that it only prints an error message:

$ function fish_command_not_found
      __fish_default_command_not_found_handler $argv[1]
  end

To make this change permanent, the built-in can be used:

$ funcsave fish_command_not_found

fish terminates any jobs put into the background when fish terminates. To keep a job running after fish terminates, first use the builtin. For example, the following starts in the background and then disowns it:

$ firefox &
$ disown

This means firefox will not be closed when the fish process is closed. See disown(1) in fish for more details.

To quickly make a persistent alias, one can simply use the method showed in this example:

$ alias lsl "ls -l"
$ funcsave lsl

alias supports the / option since fish version 3.0:

$ alias -s lsl "ls -l"

This will create the function:

function lsl
    ls -l $argv
end

and will set the alias as a persistent shell function. To see all functions and/or edit them, one can simply use and look into the Function tab in the web configuration page.

For more detailed information, see alias - create a function — fish-shell.

is a smarter cd command that lets you navigate anywhere in just a few keystrokes. It remembers your frequently used directories and uses a scoring mechanism to guess where you want to go.