3 homepage: https://github.com/fish-shell/fish-shell
5 fish is a smart and user-friendly command line shell for Linux, macOS, and the rest of the family.
12 Use the `@beta` tag for pre-releases.
16 > Finally, a command line shell for the 90s!
18 > fish includes features like syntax highlighting, autosuggest-as-you-type, and
19 > fancy tab completions that just work, with no configuration required.
21 !["fish features"](https://i.imgur.com/WVCyf5N.png)
23 `fish` is an _excellent_ command line shell for day-to-day file browsing and
24 running commands (the _BEST_, in fact).
26 However, it is **NOT** compatible with `bash` so you should still write and run
27 your scripts with bash.
29 This also covers how to
31 - Run bash scripts with bash
32 - Set vim to keep using bash
33 - Set fish as the default shell in **Linux**
34 - Set fish as the default shell in various Terminals
39 - Find fish's config files
40 - Set the default shell back to `bash`
42 ### How to run bash scripts from fish
44 A bash script should have a "bash shebang" (`#!/bin/bash`) as the first line of
50 echo "Who am I? I'm $(whoami)."
53 You can also run bash explicitly:
59 ### How to set the fish Color Scheme
61 You may like to have your `fish` theme match your Terminal or iTerm2 theme (such
62 as _Solarized_, _Dracula_, or _Tomorrow Night_).
68 ### How to set vim to keep using bash
70 The first line of your `.vimrc` should always be `set shell=/bin/bash`.
78 ### How to make fish the default shell on Linux
80 This requires editing a protected system file, `/etc/shells`. It is better to
81 use the Terminal-specific methods.
83 First, `fish` must be installed and in the `PATH`.
86 # if you don't see a file path as output, fish is not in the path
90 Second, fish must be in the system-approved list of shells in `/etc/shells`:
95 if ! grep $(which fish) /etc/shells > /dev/null; then
96 sudo bash -c "echo '$(which fish)' >> /etc/shells";
97 echo "added '$(which fish)' to /etc/shells"
101 You should use `chsh` to change your shell:
106 sudo chsh -s "$(which fish)" "$(whoami)"
109 If vim uses `fish` instead of `bash`, annoying errors will happen.
111 ### How to switch to fish
113 You can simply type `fish` and hit enter to start using fish from any other
116 You can also set is as the default for a particular Terminal, or for your user.
118 ### How to set fish as the Terminal.app shell
120 Find out where `fish` is:
126 Then update the Terminal preferences:
129 Terminal > Preferences > General > Shells open with:
130 /Users/YOUR_USER/.local/bin/fish
133 ![Terminal.app preferences](https://i.imgur.com/bulS4Vv.png)
135 Or, you can quit Terminal and change the preferences from the command line:
140 defaults write com.apple.Terminal "Shell" -string "$HOME/.local/bin/fish"
143 ### How to set fish as the iTerm2 shell
145 Find out where `fish` is:
151 Then update iTerm2 preferences:
154 iTerm2 > Preferences > Profiles > General > Command >
155 Custom Shell: /Users/YOUR_USER/.local/bin/fish
158 ![iTerm2 Preferences](https://i.imgur.com/VtBUzVH.png)
160 Or, you can quit iTerm2 and change the preferences from the command line:
165 /usr/libexec/PlistBuddy -c "SET ':New Bookmarks:0:Custom Command' 'Custom Shell'" \
166 ~/Library/Preferences/com.googlecode.iterm2.plist
168 /usr/libexec/PlistBuddy -c "SET ':New Bookmarks:0:Command' 'Custom Shell' '$HOME/.local/bin/fish'" \
169 ~/Library/Preferences/com.googlecode.iterm2.plist
172 ### How to set fish as the Hyper shell
174 Hyper is configured with JavaScript.
182 shell: process.env.HOME + '/.local/bin/fish'
187 ### How to set fish as the Alacritty shell
189 `~/.config/alacritty/alacritty.yml` should contain the shell config:
193 program: /Users/YOUR_USER/.local/bin/fish
198 If you don't yet have an alacritty config, this will do:
203 mkdir -p ~/.config/alacritty
205 cat << EOF >> ~/.config/alacritty/alacritty.yml:
207 program: $HOME/.local/bin/fish
213 The default `alacritty.yml` is included as an _asset_ with each
214 [Github release](https://github.com/alacritty/alacritty/releases).
216 ### Where is the fish config?
218 Fish will be installed to the standard user location:
224 It's config will also go in the standard user location:
227 ~/.config/fish/config.fish
230 ### How to set the default shell back to bash
232 See the instructions above for "How to make fish the default shell in _X_", but
233 use `/bin/bash` as the path instead of `$HOME/.local/bin/fish`.