fish 3.1.2 (released April 29, 2020)

Commands such as fzf and enhancd , when used with eval , would hang. eval buffered output too aggressively, which has been fixed (#6955).

fish 3.1.1 (released April 27, 2020)

Commands which involve . ( ... | psub) now work correctly, as a bug in the function --on-job-exit option has been fixed (#6613).

now work correctly, as a bug in the option has been fixed (#6613). Conflicts between upstream packages for ripgrep and bat, and the fish packages, have been resolved (#5822).

Starting fish in a directory without read access, such as via su , no longer crashes (#6597).

, no longer crashes (#6597). Glob ordering changes which were introduced in 3.1.0 have been reverted, returning the order of globs to the previous state (#6593).

Redirections using the deprecated caret syntax to a file descriptor (eg ^&2 ) work correctly (#6591).

) work correctly (#6591). Redirections that append to a file descriptor (eg 2>>&1 ) work correctly (#6614).

) work correctly (#6614). Building fish on macOS (#6602) or with new versions of GCC (#6604, #6609) is now successful.

time is now correctly listed in the output of builtin -n , and time --help works correctly (#6598).

is now correctly listed in the output of , and works correctly (#6598). Exported universal variables now update properly (#6612).

status current-command gives the expected output when used with an environment override - that is, F=B status current-command returns status instead of F=B (#6635).

gives the expected output when used with an environment override - that is, returns instead of (#6635). test no longer crashes when used with " nan " or " inf " arguments, erroring out instead (#6655).

no longer crashes when used with " " or " " arguments, erroring out instead (#6655). Copying from the end of the command line no longer crashes fish (#6680).

read no longer removes multiple separators when splitting a variable into a list, restoring the previous behaviour from fish 3.0 and before (#6650).

no longer removes multiple separators when splitting a variable into a list, restoring the previous behaviour from fish 3.0 and before (#6650). Functions using --on-job-exit and --on-process-exit work reliably again (#6679).

and work reliably again (#6679). Functions using --on-signal INT work reliably in interactive sessions, as they did in fish 2.7 and before (#6649). These handlers have never worked in non-interactive sessions, and making them work is an ongoing process.

work reliably in interactive sessions, as they did in fish 2.7 and before (#6649). These handlers have never worked in non-interactive sessions, and making them work is an ongoing process. Functions using --on-variable work reliably with variables which are set implicitly (rather than with set ), such as " fish_bind_mode " and " PWD " (#6653).

work reliably with variables which are set implicitly (rather than with ), such as " " and " " (#6653). 256 colors are properly enabled under certain conditions that were incorrectly detected in fish 3.1.0 ( $TERM begins with xterm, does not include " 256color ", and $TERM_PROGRAM is not set) (#6701).

begins with xterm, does not include " ", and is not set) (#6701). The Mercurial ( hg ) prompt no longer produces an error when the current working directory is removed (#6699). Also, for performance reasons it shows only basic information by default; to restore the detailed status, set $fish_prompt_hg_show_informative_status .

) prompt no longer produces an error when the current working directory is removed (#6699). Also, for performance reasons it shows only basic information by default; to restore the detailed status, set . The VCS prompt, fish_vcs_prompt , no longer displays Subversion ( svn ) status by default, due to the potential slowness of this operation (#6681).

, no longer displays Subversion ( ) status by default, due to the potential slowness of this operation (#6681). Pasting of commands has been sped up (#6713).

Using extended Unicode characters, such as emoji, in a non-Unicode capable locale (such as the C or POSIX locale) no longer renders all output blank (#6736).

or locale) no longer renders all output blank (#6736). help prefers to use xdg-open , avoiding the use of open on Debian systems where this command is actually openvt (#6739).

prefers to use , avoiding the use of on Debian systems where this command is actually (#6739). Command lines starting with a space, which are not saved in history, now do not get autosuggestions. This fixes an issue with Midnight Commander integration (#6763), but may be changed in a future version.

Copying to the clipboard no longer inserts a newline at the end of the content, matching fish 2.7 and earlier (#6927).

fzf in complex pipes no longer hangs. More generally, code run as part of command substitutions or eval will no longer have separate process groups. (#6624, #6806).

a number of changes to improve macOS compatibility with code signing and notarization;

a number of improvements to completions; and

a number of content and formatting improvements to the documentation.

Errata for fish 3.1

time

test

function

time

fish 3.1.0 (released February 12, 2020)

fixes a regression where spaces after a brace were removed despite brace expansion not occurring (#6564)

fixes a number of problems in compiling and testing on Cygwin (#6549) and Solaris-derived systems such as Illumos (#6553, #6554, #6555, #6556, and #6558);

fixes the process for building macOS packages;

fixes a regression where excessive error messages are printed if Unicode characters are emitted in non-Unicode-capable locales (#6584); and

contains some improvements to the documentation and a small number of completions.

Release notes for fish 3.1b1 (released January 26, 2020)

Notable improvements and fixes

A new $pipestatus variable contains a list of exit statuses of the previous job, for each of the separate commands in a pipeline (#5632).

variable contains a list of exit statuses of the previous job, for each of the separate commands in a pipeline (#5632). fish no longer buffers pipes to the last function in a pipeline, improving many cases where pipes appeared to block or hang (#1396).

An overhaul of error messages for builtin commands, including a removal of the overwhelming usage summary, more readable stack traces (#3404, #5434), and stack traces for test (aka [ ) (#5771).

(aka ) (#5771). fish's debugging arguments have been significantly improved. The --debug-level option has been removed, and a new --debug option replaces it. This option accepts various categories, which may be listed via fish --print-debug-categories (#5879). A new --debug-output option allows for redirection of debug output.

option has been removed, and a new option replaces it. This option accepts various categories, which may be listed via (#5879). A new option allows for redirection of debug output. string has a new collect subcommand for use in command substitutions, producing a single output instead of splitting on new lines (similar to "$(cmd)" in other shells) (#159).

has a new subcommand for use in command substitutions, producing a single output instead of splitting on new lines (similar to in other shells) (#159). The fish manual, tutorial and FAQ are now available in man format as fish-doc , fish-tutorial and fish-faq respectively (#5521).

format as , and respectively (#5521). Like other shells, cd now always looks for its argument in the current directory as a last resort, even if the CDPATH variable does not include it or "." (#4484).

now always looks for its argument in the current directory as a last resort, even if the variable does not include it or "." (#4484). fish now correctly handles CDPATH entries that start with .. (#6220) or contain ./ (#5887).

entries that start with (#6220) or contain (#5887). The fish_trace variable may be set to trace execution (#3427). This performs a similar role as set -x in other shells.

variable may be set to trace execution (#3427). This performs a similar role as in other shells. fish uses the temporary directory determined by the system, rather than relying on /tmp (#3845).

(#3845). The fish Web configuration tool ( fish_config ) prints a list of commands it is executing, to help understanding and debugging (#5584).

) prints a list of commands it is executing, to help understanding and debugging (#5584). Major performance improvements when pasting (#5866), executing lots of commands (#5905), importing history from bash (#6295), and when completing variables that might match $history (#6288).

Syntax changes and new commands

A new builtin command, time , which allows timing of fish functions and builtins as well as external commands (#117).

, which allows timing of fish functions and builtins as well as external commands (#117). Brace expansion now only takes place if the braces include a "," or a variable expansion, meaning common commands such as git reset HEAD@{0} do not require escaping (#5869).

do not require escaping (#5869). New redirections &> and &| may be used to redirect or pipe stdout, and also redirect stderr to stdout (#6192).

and may be used to redirect or pipe stdout, and also redirect stderr to stdout (#6192). switch now allows arguments that expand to nothing, like empty variables (#5677).

now allows arguments that expand to nothing, like empty variables (#5677). The VAR=val cmd syntax can now be used to run a command in a modified environment (#6287).

syntax can now be used to run a command in a modified environment (#6287). and is no longer recognised as a command, so that nonsensical constructs like and and and produce a syntax error (#6089).

is no longer recognised as a command, so that nonsensical constructs like produce a syntax error (#6089). math 's exponent operator, ' ^ ', was previously left-associative, but now uses the more commonly-used right-associative behaviour (#6280). This means that math '3^0.5^2' was previously calculated as '(3^0.5)^2', but is now calculated as '3^(0.5^2)'.

's exponent operator, ' ', was previously left-associative, but now uses the more commonly-used right-associative behaviour (#6280). This means that was previously calculated as '(3^0.5)^2', but is now calculated as '3^(0.5^2)'. In fish 3.0, the variable used with for loops inside command substitutions could leak into enclosing scopes; this was an inadvertent behaviour change and has been reverted (#6480).

Scripting improvements

string split0 now returns 0 if it split something (#5701).

now returns 0 if it split something (#5701). In the interest of consistency, builtin -q and command -q can now be used to query if a builtin or command exists (#5631).

and can now be used to query if a builtin or command exists (#5631). math now accepts --scale=max for the maximum scale (#5579).

now accepts for the maximum scale (#5579). builtin $var now works correctly, allowing a variable as the builtin name (#5639).

now works correctly, allowing a variable as the builtin name (#5639). cd understands the -- argument to make it possible to change to directories starting with a hyphen (#6071).

understands the argument to make it possible to change to directories starting with a hyphen (#6071). complete --do-complete now also does fuzzy matches (#5467).

now also does fuzzy matches (#5467). complete --do-complete can be used inside completions, allowing limited recursion (#3474).

can be used inside completions, allowing limited recursion (#3474). count now also counts lines fed on standard input (#5744).

now also counts lines fed on standard input (#5744). eval produces an exit status of 0 when given no arguments, like other shells (#5692).

produces an exit status of 0 when given no arguments, like other shells (#5692). printf prints what it can when input hasn't been fully converted to a number, but still prints an error (#5532).

prints what it can when input hasn't been fully converted to a number, but still prints an error (#5532). complete -C foo now works as expected, rather than requiring complete -Cfoo .

now works as expected, rather than requiring . complete has a new --force-files option, to re-enable file completions. This allows sudo -E and pacman -Qo to complete correctly (#5646).

has a new option, to re-enable file completions. This allows and to complete correctly (#5646). argparse now defaults to showing the current function name (instead of argparse ) in its errors, making --name often superfluous (#5835).

now defaults to showing the current function name (instead of ) in its errors, making often superfluous (#5835). argparse has a new --ignore-unknown option to keep unrecognized options, allowing multiple argparse passes to parse options (#5367).

has a new option to keep unrecognized options, allowing multiple argparse passes to parse options (#5367). argparse correctly handles flag value validation of options that only have short names (#5864).

correctly handles flag value validation of options that only have short names (#5864). read -S (short option of --shell ) is recognised correctly (#5660).

(short option of ) is recognised correctly (#5660). read understands --list , which acts like --array in reading all arguments into a list inside a single variable, but is better named (#5846).

understands , which acts like in reading all arguments into a list inside a single variable, but is better named (#5846). read has a new option, --tokenize , which splits a string into variables according to the shell's tokenization rules, considering quoting, escaping, and so on (#3823).

has a new option, , which splits a string into variables according to the shell's tokenization rules, considering quoting, escaping, and so on (#3823). read interacts more correctly with the deprecated $IFS variable, in particular removing multiple separators when splitting a variable into a list (#6406), matching other shells.

interacts more correctly with the deprecated variable, in particular removing multiple separators when splitting a variable into a list (#6406), matching other shells. fish_indent now handles semicolons better, including leaving them in place for ; and and ; or instead of breaking the line (#5859).

now handles semicolons better, including leaving them in place for and instead of breaking the line (#5859). fish_indent --write now supports multiple file arguments, indenting them in turn.

now supports multiple file arguments, indenting them in turn. The default read limit has been increased to 100MiB (#5267).

math now also understands x for multiplication, provided it is followed by whitespace (#5906).

now also understands for multiplication, provided it is followed by whitespace (#5906). math reports the right error when incorrect syntax is used inside parentheses (#6063), and warns when unsupported logical operations are used (#6096).

reports the right error when incorrect syntax is used inside parentheses (#6063), and warns when unsupported logical operations are used (#6096). functions --erase now also prevents fish from autoloading a function for the first time (#5951).

now also prevents fish from autoloading a function for the first time (#5951). jobs --last returns 0 to indicate success when a job is found (#6104).

returns 0 to indicate success when a job is found (#6104). commandline -p and commandline -j now split on && and || in addition to ; and & (#6214).

and now split on and in addition to and (#6214). A bug where string split would drop empty strings if the output was only empty strings has been fixed (#5987).

would drop empty strings if the output was only empty strings has been fixed (#5987). eval no long creates a new local variable scope, but affects variables in the scope it is called from (#4443). source still creates a new local scope.

no long creates a new local variable scope, but affects variables in the scope it is called from (#4443). still creates a new local scope. abbr has a new --query option to check for the existence of an abbreviation.

has a new option to check for the existence of an abbreviation. Local values for fish_complete_path and fish_function_path are now ignored; only their global values are respected.

and are now ignored; only their global values are respected. Syntax error reports now display a marker in the correct position (#5812).

Empty universal variables may now be exported (#5992).

Exported universal variables are no longer imported into the global scope, preventing shadowing. This makes it easier to change such variables for all fish sessions and avoids breakage when the value is a list of multiple elements (#5258).

A bug where for could use invalid variable names has been fixed (#5800).

could use invalid variable names has been fixed (#5800). A bug where local variables would not be exported to functions has been fixed (#6153).

The null command ( : ) now always exits successfully, rather than passing through the previous exit status (#6022).

) now always exits successfully, rather than passing through the previous exit status (#6022). The output of functions FUNCTION matches the declaration of the function, correctly including comments or blank lines (#5285), and correctly includes any --wraps flags (#1625).

matches the declaration of the function, correctly including comments or blank lines (#5285), and correctly includes any flags (#1625). type supports a new option, --short , which suppress function expansion (#6403).

supports a new option, , which suppress function expansion (#6403). type --path with a function argument will now output the path to the file containing the definition of that function, if it exists.

with a function argument will now output the path to the file containing the definition of that function, if it exists. type --force-path with an argument that cannot be found now correctly outputs nothing, as documented (#6411).

with an argument that cannot be found now correctly outputs nothing, as documented (#6411). The $hostname variable is no longer truncated to 32 characters (#5758).

variable is no longer truncated to 32 characters (#5758). Line numbers in function backtraces are calculated correctly (#6350).

A new fish_cancel event is emitted when the command line is cancelled, which is useful for terminal integration (#5973).

Interactive improvements

New Base16 color options are available through the Web-based configuration (#6504).

fish only parses /etc/paths on macOS in login shells, matching the bash implementation (#5637) and avoiding changes to path ordering in child shells (#5456). It now ignores blank lines like the bash implementation (#5809).

on macOS in login shells, matching the bash implementation (#5637) and avoiding changes to path ordering in child shells (#5456). It now ignores blank lines like the bash implementation (#5809). The locale is now reloaded when the LOCPATH variable is changed (#5815).

variable is changed (#5815). read no longer keeps a history, making it suitable for operations that shouldn't end up there, like password entry (#5904).

no longer keeps a history, making it suitable for operations that shouldn't end up there, like password entry (#5904). dirh outputs its stack in the correct order (#5477), and behaves as documented when universal variables are used for its stack (#5797).

outputs its stack in the correct order (#5477), and behaves as documented when universal variables are used for its stack (#5797). funced and the edit-commandline-in-buffer bindings did not work in fish 3.0 when the $EDITOR variable contained spaces; this has been corrected (#5625).

and the edit-commandline-in-buffer bindings did not work in fish 3.0 when the variable contained spaces; this has been corrected (#5625). Builtins now pipe their help output to a pager automatically (#6227).

set_color now colors the --print-colors output in the matching colors if it is going to a terminal.

now colors the output in the matching colors if it is going to a terminal. fish now underlines every valid entered path instead of just the last one (#5872).

When syntax highlighting a string with an unclosed quote, only the quote itself will be shown as an error, instead of the whole argument.

Syntax highlighting works correctly with variables as commands (#5658) and redirections to close file descriptors (#6092).

help works properly on Windows Subsytem for Linux (#5759, #6338).

works properly on Windows Subsytem for Linux (#5759, #6338). A bug where disown could crash the shell has been fixed (#5720).

could crash the shell has been fixed (#5720). fish will not autosuggest files ending with ~ unless there are no other candidates, as these are generally backup files (#985).

unless there are no other candidates, as these are generally backup files (#985). Escape in the pager works correctly (#5818).

Key bindings that call fg no longer leave the terminal in a broken state (#2114).

no longer leave the terminal in a broken state (#2114). Brackets (#5831) and filenames containing $ (#6060) are completed with appropriate escaping.

(#6060) are completed with appropriate escaping. The output of complete and functions is now colorized in interactive terminals.

and is now colorized in interactive terminals. The Web-based configuration handles aliases that include single quotes correctly (#6120), and launches correctly under Termux (#6248) and OpenBSD (#6522).

function now correctly validates parameters for --argument-names as valid variable names (#6147) and correctly parses options following --argument-names , as in " --argument-names foo --description bar " (#6186).

now correctly validates parameters for as valid variable names (#6147) and correctly parses options following , as in " " (#6186). History newly imported from bash includes command lines using && or || .

or . The automatic generation of completions from manual pages is better described in job and process listings, and no longer produces a warning when exiting fish (#6269).

In private mode, setting $fish_greeting to an empty string before starting the private session will prevent the warning about history not being saved from being printed (#6299).

to an empty string before starting the private session will prevent the warning about history not being saved from being printed (#6299). In the interactive editor, a line break (Enter) inside unclosed brackets will insert a new line, rather than executing the command and producing an error (#6316).

Ctrl-C always repaints the prompt (#6394).

When run interactively from another program (such as Python), fish will correctly start a new process group, like other shells (#5909).

Job identifiers (for example, for background jobs) are assigned more logically (#6053).

A bug where history would appear truncated if an empty command was executed was fixed (#6032).

New or improved bindings

Pasting strips leading spaces to avoid pasted commands being omitted from the history (#4327).

Shift-Left and Shift-Right now default to moving backwards and forwards by one bigword (words separated by whitespace) (#1505).

The default escape delay (to differentiate between the escape key and an alt-combination) has been reduced to 30ms, down from 300ms for the default mode and 100ms for Vi mode (#3904).

The forward-bigword binding now interacts correctly with autosuggestions (#5336).

binding now interacts correctly with autosuggestions (#5336). The fish_clipboard_* functions support Wayland by using [ wl-clipboard ](https://github.com/bugaevc/wl-clipboard) (#5450).

functions support Wayland by using [ ](https://github.com/bugaevc/wl-clipboard) (#5450). The nextd and prevd functions no longer print "Hit end of history", instead using a bell. They correctly store working directories containing symbolic links (#6395).

and functions no longer print "Hit end of history", instead using a bell. They correctly store working directories containing symbolic links (#6395). If a fish_mode_prompt function exists, Vi mode will only execute it on mode-switch instead of the entire prompt. This should make it much more responsive with slow prompts (#5783).

function exists, Vi mode will only execute it on mode-switch instead of the entire prompt. This should make it much more responsive with slow prompts (#5783). The path-component bindings (like Ctrl-w) now also stop at ":" and "@", because those are used to denote user and host in commands such as ssh (#5841).

(#5841). The NULL character can now be bound via bind -k nul . Terminals often generate this character via control-space. (#3189).

. Terminals often generate this character via control-space. (#3189). A new readline command expand-abbr can be used to trigger abbreviation expansion (#5762).

can be used to trigger abbreviation expansion (#5762). A new readline command, delete-or-exit , removes a character to the right of the cursor or exits the shell if the command line is empty (moving this functionality out of the delete-or-exit function).

, removes a character to the right of the cursor or exits the shell if the command line is empty (moving this functionality out of the function). The self-insert readline command will now insert the binding sequence, if not empty.

readline command will now insert the binding sequence, if not empty. A new binding to prepend sudo , bound to Alt-S by default (#6140).

, bound to Alt-S by default (#6140). The Alt-W binding to describe a command should now work better with multiline prompts (#6110)

The Alt-H binding to open a command's man page now tries to ignore sudo (#6122).

(#6122). A new pair of bind functions, history-prefix-search-backward (and forward ), was introduced (#6143).

(and ), was introduced (#6143). Vi mode now supports R to enter replace mode (#6342), and d0 to delete the current line (#6292).

to delete the current line (#6292). In Vi mode, hitting Enter in replace-one mode no longer erases the prompt (#6298).

Selections in Vi mode are inclusive, matching the actual behaviour of Vi (#5770).

Improved prompts

The Git prompt in informative mode now shows the number of stashes if enabled.

The Git prompt now has an option ( $__fish_git_prompt_use_informative_chars ) to use the (more modern) informative characters without enabling informative mode.

) to use the (more modern) informative characters without enabling informative mode. The default prompt now also features VCS integration and will color the host if running via SSH (#6375).

The default and example prompts print the pipe status if an earlier command in the pipe fails.

The default and example prompts try to resolve exit statuses to signal names when appropriate.

Improved terminal output

New fish_pager_color_ options have been added to control more elements of the pager's colors (#5524).

options have been added to control more elements of the pager's colors (#5524). Better detection and support for using fish from various system consoles, where limited colors and special characters are supported (#5552).

fish now tries to guess if the system supports Unicode 9 (and displays emoji as wide), eliminating the need to set $fish_emoji_width in most cases (#5722).

in most cases (#5722). Improvements to the display of wide characters, particularly Korean characters and emoji (#5583, #5729).

The Vi mode cursor is correctly redrawn when regaining focus under terminals that report focus (eg tmux) (#4788).

Variables that control background colors (such as fish_pager_color_search_match ) can now use --reverse .

Completions

Added completions for

aws

bat (#6052)

(#6052) bosh (#5700)

(#5700) btrfs

camcontrol

cf (#5700)

(#5700) chronyc (#6496)

(#6496) code (#6205)

(#6205) cryptsetup (#6488)

(#6488) csc and csi (#6016)

and (#6016) cwebp (#6034)

(#6034) cygpath and cygstart (#6239)

and (#6239) epkginfo (#5829)

(#5829) ffmpeg , ffplay , and ffprobe (#5922)

, , and (#5922) fsharpc and fsharpi (#6016)

and (#6016) fzf (#6178)

(#6178) g++ (#6217)

(#6217) gpg1 (#6139)

(#6139) gpg2 (#6062)

(#6062) grub-mkrescue (#6182)

(#6182) hledger (#6043)

(#6043) hwinfo (#6496)

(#6496) irb (#6260)

(#6260) iw (#6232)

(#6232) kak

keepassxc-cli (#6505)

(#6505) keybase (#6410)

(#6410) loginctl (#6501)

(#6501) lz4 , lz4c and lz4cat (#6364)

, and (#6364) mariner (#5718)

(#5718) nethack (#6240)

(#6240) patool (#6083)

(#6083) phpunit (#6197)

(#6197) plutil (#6301)

(#6301) pzstd (#6364)

(#6364) qubes-gpg-client (#6067)

(#6067) resolvectl (#6501)

(#6501) rg

rustup

sfdx (#6149)

(#6149) speedtest and speedtest-cli (#5840)

and (#5840) src (#6026)

(#6026) tokei (#6085)

(#6085) tsc (#6016)

(#6016) unlz4 (#6364)

(#6364) unzstd (#6364)

(#6364) vbc (#6016)

(#6016) zpaq (#6245)

(#6245) zstd , zstdcat , zstdgrep , zstdless and zstdmt (#6364)

, , , and (#6364) Lots of improvements to completions.

Selecting short options which also have a long name from the completion pager is possible (#5634).

Tab completion will no longer add trailing spaces if they already exist (#6107).

Completion of subcommands to builtins like and or not now works correctly (#6249).

or now works correctly (#6249). Completion of arguments to short options works correctly when multiple short options are used together (#332).

Activating completion in the middle of an invalid completion does not move the cursor any more, making it easier to fix a mistake (#4124).

Completion in empty commandlines now lists all available commands.

Functions listed as completions could previously leak parts of the function as other completions; this has been fixed.

Deprecations and removed features

The vcs-prompt functions have been promoted to names without double-underscore, so __fish_git_prompt is now fish_git_prompt, __fish_vcs_prompt is now fish_vcs_prompt, __fish_hg_prompt is now fish_hg_prompt and __fish_svn_prompt is now fish_svn_prompt. Shims at the old names have been added, and the variables have kept their old names (#5586).

string replace has an additional round of escaping in the replacement expression, so escaping backslashes requires many escapes (eg string replace -ra '([ab])' '\\\\\\\$1' a ). The new feature flag regex-easyesc can be used to disable this, so that the same effect can be achieved with string replace -ra '([ab])' '\\\\$1' a (#5556). As a reminder, the intention behind feature flags is that this will eventually become the default and then only option, so scripts should be updated.

has an additional round of escaping in the replacement expression, so escaping backslashes requires many escapes (eg ). The new feature flag can be used to disable this, so that the same effect can be achieved with (#5556). As a reminder, the intention behind feature flags is that this will eventually become the default and then only option, so scripts should be updated. The fish_vi_mode function, deprecated in fish 2.3, has been removed. Use fish_vi_key_bindings instead (#6372).

For distributors and developers

fish 3.0 introduced a CMake-based build system. In fish 3.1, both the Autotools-based build and legacy Xcode build system have been removed, leaving only the CMake build system. All distributors and developers must install CMake.

fish now depends on the common tee external command, for the psub process substitution function.

external command, for the process substitution function. The documentation is now built with Sphinx. The old Doxygen-based documentation system has been removed. Developers, and distributors who wish to rebuild the documentation, must install Sphinx.

The INTERNAL_WCWIDTH build option has been removed, as fish now always uses an internal wcwidth function. It has a number of configuration options that make it more suitable for general use (#5777).

build option has been removed, as fish now always uses an internal function. It has a number of configuration options that make it more suitable for general use (#5777). mandoc can now be used to format the output from --help if nroff is not installed, reducing the number of external dependencies on systems with mandoc installed (#5489).

if is not installed, reducing the number of external dependencies on systems with installed (#5489). Some bugs preventing building on Solaris-derived systems such as Illumos were fixed (#5458, #5461, #5611).

Completions for npm , bower and yarn no longer require the jq utility for full functionality, but will use Python instead if it is available.

, and no longer require the utility for full functionality, but will use Python instead if it is available. The paths for completions, functions and configuration snippets have been extended. On systems that define XDG_DATA_DIRS , each of the directories in this variable are searched in the subdirectories fish/vendor_completions.d , fish/vendor_functions.d , and fish/vendor_conf.d respectively. On systems that do not define this variable in the environment, the vendor directories are searched for in both the installation prefix and the default "extra" directory, which now defaults to /usr/local (#5029).

Release Notes for fish 3.0.2 (released February 19, 2019)

Fixes and improvements

The PWD environment variable is now ignored if it does not resolve to the true working directory, fixing strange behaviour in terminals started by editors and IDEs (#5647).

Release Notes for fish 3.0.1 (released February 11, 2019)

Fixes and improvements

exec does not complain about running foreground jobs when called (#5449).

does not complain about running foreground jobs when called (#5449). while loops now evaluate to the last executed command in the loop body (or zero if the body was empty), matching POSIX semantics (#4982).

read --silent no longer echoes to the tty when run from a non-interactive script (#5519).

no longer echoes to the tty when run from a non-interactive script (#5519). On macOS, path entries with spaces in /etc/paths and /etc/paths.d now correctly set path entries with spaces. Likewise, MANPATH is correctly set from /etc/manpaths and /etc/manpaths.d (#5481).

and now correctly set path entries with spaces. Likewise, is correctly set from and (#5481). fish starts correctly under Cygwin/MSYS2 (#5426).

The pager-toggle-search binding (Ctrl-S by default) will now activate the search field, even when the pager is not focused.

binding (Ctrl-S by default) will now activate the search field, even when the pager is not focused. The error when a command is not found is now printed a single time, instead of once per argument (#5588).

Fixes and improvements to the git completions, including printing correct paths with older git versions, fuzzy matching again, reducing unnecessary offers of root paths (starting with :/ ) (#5578, #5574, #5476), and ignoring shell aliases, so enterprising users can set up the wrapping command (via set -g __fish_git_alias_$command $whatitwraps ) (#5412).

) (#5578, #5574, #5476), and ignoring shell aliases, so enterprising users can set up the wrapping command (via ) (#5412). Significant performance improvements to core shell functions (#5447) and to the kill completions (#5541).

completions (#5541). Starting in symbolically-linked working directories works correctly (#5525).

The default fish_title function no longer contains extra spaces (#5517).

function no longer contains extra spaces (#5517). The nim prompt now works correctly when chosen in the Web-based configuration (#5490).

prompt now works correctly when chosen in the Web-based configuration (#5490). string now prints help to stdout, like other builtins (#5495).

now prints help to stdout, like other builtins (#5495). Killing the terminal while fish is in vi normal mode will no longer send it spinning and eating CPU. (#5528)

A number of crashes have been fixed (#5550, #5548, #5479, #5453).

Improvements to the documentation and certain completions.

Release Notes for fish 3.0.0 (released December 28, 2018)

Notable non-backward compatible changes

Process and job expansion has largely been removed. % will no longer perform these expansions, except for %self for the PID of the current shell. Additionally, job management commands ( disown , wait , bg , fg and kill ) will expand job specifiers starting with % (#4230, #1202).

will no longer perform these expansions, except for for the PID of the current shell. Additionally, job management commands ( , , , and ) will expand job specifiers starting with (#4230, #1202). set x[1] x[2] a b , to set multiple elements of an array at once, is no longer valid syntax (#4236).

, to set multiple elements of an array at once, is no longer valid syntax (#4236). A literal {} now expands to itself, rather than nothing. This makes working with find -exec easier (#1109, #4632).

now expands to itself, rather than nothing. This makes working with easier (#1109, #4632). Literally accessing a zero-index is now illegal syntax and is caught by the parser (#4862). (fish indices start at 1)

Successive commas in brace expansions are handled in less surprising manner. For example, {,,,} expands to four empty strings rather than an empty string, a comma and an empty string again (#3002, #4632).

expands to four empty strings rather than an empty string, a comma and an empty string again (#3002, #4632). for loop control variables are no longer local to the for block (#1935).

loop control variables are no longer local to the block (#1935). Variables set in if and while conditions are available outside the block (#4820).

and conditions are available outside the block (#4820). Local exported ( set -lx ) vars are now visible to functions (#1091).

) vars are now visible to functions (#1091). The new math builtin (see below) does not support logical expressions; test should be used instead (#4777).

builtin (see below) does not support logical expressions; should be used instead (#4777). Range expansion will now behave sensibly when given a single positive and negative index ( $foo[5..-1] or $foo[-1..5] ), clamping to the last valid index without changing direction if the list has fewer elements than expected.

or ), clamping to the last valid index without changing direction if the list has fewer elements than expected. read now uses -s as short for --silent (à la bash ); --shell 's abbreviation (formerly -s ) is now -S instead (#4490).

now uses as short for (à la ); 's abbreviation (formerly ) is now instead (#4490). cd no longer resolves symlinks. fish now maintains a virtual path, matching other shells (#3350).

no longer resolves symlinks. fish now maintains a virtual path, matching other shells (#3350). source now requires an explicit - as the filename to read from the terminal (#2633).

now requires an explicit as the filename to read from the terminal (#2633). Arguments to end are now errors, instead of being silently ignored.

are now errors, instead of being silently ignored. The names argparse , read , set , status , test and [ are now reserved and not allowed as function names. This prevents users unintentionally breaking stuff (#3000).

, , , , and are now reserved and not allowed as function names. This prevents users unintentionally breaking stuff (#3000). The fish_user_abbreviations variable is no longer used; abbreviations will be migrated to the new storage format automatically.

variable is no longer used; abbreviations will be migrated to the new storage format automatically. The FISH_READ_BYTE_LIMIT variable is now called fish_byte_limit (#4414).

variable is now called (#4414). Environment variables are no longer split into arrays based on the record separator character on startup. Instead, variables are not split, unless their name ends in PATH, in which case they are split on colons (#436).

The history builtin's --with-time option has been removed; this has been deprecated in favor of --show-time since 2.7.0 (#4403).

builtin's option has been removed; this has been deprecated in favor of since 2.7.0 (#4403). The internal variables __fish_datadir and __fish_sysconfdir are now known as __fish_data_dir and __fish_sysconf_dir respectively.

Deprecations

fish --features ...

fish_features

The use of the IFS variable for read is deprecated; IFS will be ignored in the future (#4156). Use the read --delimiter option instead.

variable for is deprecated; will be ignored in the future (#4156). Use the option instead. The function --on-process-exit switch will be removed in future (#4700). Use the fish_exit event instead: function --on-event fish_exit .

switch will be removed in future (#4700). Use the event instead: . $_ is deprecated and will removed in the future (#813). Use status current-command in a command substitution instead.

is deprecated and will removed in the future (#813). Use in a command substitution instead. ^ as a redirection deprecated and will be removed in the future. (#4394). Use 2> to redirect stderr. This is controlled by the stderr-nocaret feature flag.

as a redirection deprecated and will be removed in the future. (#4394). Use to redirect stderr. This is controlled by the feature flag. ? as a glob (wildcard) is deprecated and will be removed in the future (#4520). This is controlled by the qmark-noglob feature flag.

Notable fixes and improvements

Syntax changes and new commands

fish now supports && (like and ), || (like or ), and ! (like not ), for better migration from POSIX-compliant shells (#4620).

(like ), (like ), and (like ), for better migration from POSIX-compliant shells (#4620). Variables may be used as commands (#154).

fish may be started in private mode via fish --private . Private mode fish sessions do not have access to the history file and any commands evaluated in private mode are not persisted for future sessions. A session variable $fish_private_mode can be queried to detect private mode and adjust the behavior of scripts accordingly to respect the user's wish for privacy.

. Private mode fish sessions do not have access to the history file and any commands evaluated in private mode are not persisted for future sessions. A session variable can be queried to detect private mode and adjust the behavior of scripts accordingly to respect the user's wish for privacy. A new wait command for waiting on backgrounded processes (#4498).

command for waiting on backgrounded processes (#4498). math is now a builtin rather than a wrapper around bc (#3157). Floating point computations is now used by default, and can be controlled with the new --scale option (#4478).

is now a builtin rather than a wrapper around (#3157). Floating point computations is now used by default, and can be controlled with the new option (#4478). Setting $PATH no longer warns on non-existent directories, allowing for a single $PATH to be shared across machines (eg via dotfiles) (#2969).

no longer warns on non-existent directories, allowing for a single $PATH to be shared across machines (eg via dotfiles) (#2969). while sets $status to a non-zero value if the loop is not executed (#4982).

sets to a non-zero value if the loop is not executed (#4982). Command substitution output is now limited to 10 MB by default, controlled by the fish_read_limit variable (#3822). Notably, this is larger than most operating systems' argument size limit, so trying to pass argument lists this size to external commands has never worked.

variable (#3822). Notably, this is larger than most operating systems' argument size limit, so trying to pass argument lists this size to external commands has never worked. The machine hostname, where available, is now exposed as the $hostname reserved variable. This removes the dependency on the hostname executable (#4422).

reserved variable. This removes the dependency on the executable (#4422). Bare bind invocations in config.fish now work. The fish_user_key_bindings function is no longer necessary, but will still be executed if it exists (#5191).

invocations in config.fish now work. The function is no longer necessary, but will still be executed if it exists (#5191). $fish_pid and $last_pid are available as replacements for %self and %last .

New features in commands

alias has a new --save option to save the generated function immediately (#4878).

has a new option to save the generated function immediately (#4878). bind has a new --silent option to ignore bind requests for named keys not available under the current terminal (#4188, #4431).

has a new option to ignore bind requests for named keys not available under the current terminal (#4188, #4431). complete has a new --keep-order option to show the provided or dynamically-generated argument list in the same order as specified, rather than alphabetically (#361).

has a new option to show the provided or dynamically-generated argument list in the same order as specified, rather than alphabetically (#361). exec prompts for confirmation if background jobs are running.

prompts for confirmation if background jobs are running. funced has a new --save option to automatically save the edited function after successfully editing (#4668).

has a new option to automatically save the edited function after successfully editing (#4668). functions has a new --handlers option to show functions registered as event handlers (#4694).

has a new option to show functions registered as event handlers (#4694). history search supports globs for wildcard searching (#3136) and has a new --reverse option to show entries from oldest to newest (#4375).

supports globs for wildcard searching (#3136) and has a new option to show entries from oldest to newest (#4375). jobs has a new --quiet option to silence the output.

has a new option to silence the output. read has a new --delimiter option for splitting input into arrays (#4256).

has a new option for splitting input into arrays (#4256). read writes directly to stdout if called without arguments (#4407).

writes directly to stdout if called without arguments (#4407). read can now read individual lines into separate variables without consuming the input in its entirety via the new /--line option.

can now read individual lines into separate variables without consuming the input in its entirety via the new option. set has new --append and --prepend options (#1326).

has new and options (#1326). set has a new --show option to show lots of information about variables (#4265).

has a new option to show lots of information about variables (#4265). string match with an empty pattern and --entire in glob mode now matches everything instead of nothing (#4971).

with an empty pattern and in glob mode now matches everything instead of nothing (#4971). string split supports a new --no-empty option to exclude empty strings from the result (#4779).

supports a new option to exclude empty strings from the result (#4779). string has new subcommands split0 and join0 for working with NUL-delimited output.

has new subcommands and for working with NUL-delimited output. string no longer stops processing text after NUL characters (#4605)

no longer stops processing text after NUL characters (#4605) string escape has a new --style regex option for escaping strings to be matched literally in string regex operations.

has a new option for escaping strings to be matched literally in regex operations. test now supports floating point values in numeric comparisons.

Interactive improvements

A pipe at the end of a line now allows the job to continue on the next line (#1285).

Italics and dim support out of the box on macOS for Terminal.app and iTerm (#4436).

cd tab completions no longer descend into the deepest unambiguous path (#4649).

tab completions no longer descend into the deepest unambiguous path (#4649). Pager navigation has been improved. Most notably, moving down now wraps around, moving up from the commandline now jumps to the last element and moving right and left now reverse each other even when wrapping around (#4680).

Typing normal characters while the completion pager is active no longer shows the search field. Instead it enters them into the command line, and ends paging (#2249).

A new input binding pager-toggle-search toggles the search field in the completions pager on and off. By default, this is bound to Ctrl-S.

toggles the search field in the completions pager on and off. By default, this is bound to Ctrl-S. Searching in the pager now does a full fuzzy search (#5213).

The pager will now show the full command instead of just its last line if the number of completions is large (#4702).

Abbreviations can be tab-completed (#3233).

Tildes in file names are now properly escaped in completions (#2274).

Wrapping completions (from complete --wraps or function --wraps ) can now inject arguments. For example, complete gco --wraps 'git checkout' now works properly (#1976). The alias function has been updated to respect this behavior.

or ) can now inject arguments. For example, now works properly (#1976). The function has been updated to respect this behavior. Path completions now support expansions, meaning expressions like python ~/<TAB> now provides file suggestions just like any other relative or absolute path. (This includes support for other expansions, too.)

now provides file suggestions just like any other relative or absolute path. (This includes support for other expansions, too.) Autosuggestions try to avoid arguments that are already present in the command line.

Notifications about crashed processes are now always shown, even in command substitutions (#4962).

The screen is no longer reset after a BEL, fixing graphical glitches (#3693).

vi-mode now supports ';' and ',' motions. This introduces new {forward,backward}-jump-till and repeat-jump{,-reverse} bind functions (#5140).

The *y vi-mode binding now works (#5100).

vi-mode binding now works (#5100). True color is now enabled in neovim by default (#2792).

Terminal size variables ( $COLUMNS / $LINES ) are now updated before fish_prompt is called, allowing the prompt to react (#904).

/ ) are now updated before is called, allowing the prompt to react (#904). Multi-line prompts no longer repeat when the terminal is resized (#2320).

xclip support has been added to the clipboard integration (#5020).

support has been added to the clipboard integration (#5020). The Alt-P keybinding paginates the last command if the command line is empty.

$cmd_duration is no longer reset when no command is executed (#5011).

is no longer reset when no command is executed (#5011). Deleting a one-character word no longer erases the next word as well (#4747).

Token history search (Alt-Up) omits duplicate entries (#4795).

The fish_escape_delay_ms timeout, allowing the use of the escape key both on its own and as part of a control sequence, was applied to all control characters; this has been reduced to just the escape key.

timeout, allowing the use of the escape key both on its own and as part of a control sequence, was applied to all control characters; this has been reduced to just the escape key. Completing a function shows the description properly (#5206).

Added completions for

ansible , including ansible-galaxy , ansible-playbook and ansible-vault (#4697)

, including , and (#4697) bb-power (#4800)

(#4800) bd (#4472)

(#4472) bower

clang and clang++ (#4174)

and (#4174) conda (#4837)

(#4837) configure (for autoconf-generated files only)

(for autoconf-generated files only) curl

doas (#5196)

(#5196) ebuild (#4911)

(#4911) emaint (#4758)

(#4758) eopkg (#4600)

(#4600) exercism (#4495)

(#4495) hjson

hugo (#4529)

(#4529) j (from autojump #4344)

(from autojump #4344) jbake (#4814)

(#4814) jhipster (#4472)

(#4472) kitty

kldload

kldunload

makensis (#5242)

(#5242) meson

mkdocs (#4906)

(#4906) ngrok (#4642)

(#4642) OpenBSD's pkg_add , pkg_delete , pkg_info , pfctl , rcctl , signify , and vmctl (#4584)

, , , , , , and (#4584) openocd

optipng

opkg (#5168)

(#5168) pandoc (#2937)

(#2937) port (#4737)

(#4737) powerpill (#4800)

(#4800) pstack (#5135)

(#5135) serve (#5026)

(#5026) ttx

unzip

virsh (#5113)

(#5113) xclip (#5126)

(#5126) xsv

zfs and zpool (#4608)

and (#4608) Lots of improvements to completions (especially darcs (#5112), git , hg and sudo ).

(#5112), , and ). Completions for yarn and npm now require the all-the-package-names NPM package for full functionality.

and now require the NPM package for full functionality. Completions for bower and yarn now require the jq utility for full functionality.

and now require the utility for full functionality. Improved French translations.

Other fixes and improvements

Significant performance improvements to abbr (#4048), setting variables (#4200, #4341), executing functions, globs (#4579), string reading from standard input (#4610), and slicing history (in particular, $history[1] for the last executed command).

(#4048), setting variables (#4200, #4341), executing functions, globs (#4579), reading from standard input (#4610), and slicing history (in particular, for the last executed command). Fish's internal wcwidth function has been updated to deal with newer Unicode, and the width of some characters can be configured via the fish_ambiguous_width (#5149) and fish_emoji_width (#2652) variables. Alternatively, a new build-time option INTERNAL_WCWIDTH can be used to use the system's wcwidth instead (#4816).

(#5149) and (#2652) variables. Alternatively, a new build-time option INTERNAL_WCWIDTH can be used to use the system's wcwidth instead (#4816). functions correctly supports -d as the short form of --description . (#5105)

correctly supports as the short form of . (#5105) /etc/paths is now parsed like macOS' bash path_helper , fixing $PATH order (#4336, #4852) on macOS.

is now parsed like macOS' bash , fixing $PATH order (#4336, #4852) on macOS. Using a read-only variable in a for loop produces an error, rather than silently producing incorrect results (#4342).

loop produces an error, rather than silently producing incorrect results (#4342). The universal variables filename no longer contains the hostname or MAC address. It is now at the fixed location .config/fish/fish_variables (#1912).

(#1912). Exported variables in the global or universal scope no longer have their exported status affected by local variables (#2611).

Major rework of terminal and job handling to eliminate bugs (#3805, #3952, #4178, #4235, #4238, #4540, #4929, #5210).

Improvements to the manual page completion generator (#2937, #4313).

suspend --force now works correctly (#4672).

now works correctly (#4672). Pressing Ctrl-C while running a script now reliably terminates fish (#5253).

For distributors and developers

fish ships with a new build system based on CMake. CMake 3.2 is the minimum required version. Although the autotools-based Makefile and the Xcode project are still shipped with this release, they will be removed in the near future. All distributors and developers are encouraged to migrate to the CMake build.

Build scripts for most platforms no longer require bash, using the standard sh instead.

The hostname command is no longer required for fish to operate.

Release Notes for fish 2.7.1 (released December 23, 2017)

Notable fixes and improvements

Release Notes for fish 2.7.0 (released November 23, 2017)

Notable fixes and improvements

A new argparse command is available to allow fish script to parse arguments with the same behavior as builtin commands. This also includes the fish_opt helper command. (#4190).

command is available to allow fish script to parse arguments with the same behavior as builtin commands. This also includes the helper command. (#4190). The COLUMNS and LINES env vars are now correctly set the first time fish_prompt is run (#4141).

and env vars are now correctly set the first time is run (#4141). New status is-breakpoint command that is true when a prompt is displayed in response to a breakpoint command (#1310).

command that is true when a prompt is displayed in response to a command (#1310). Invalid array indexes are now silently ignored (#826, #4127).

string escape has a new --style=xxx flag where xxx can be script , var , or url (#4150).

has a new flag where can be , , or (#4150). string unescape has been implemented to reverse the effects of string escape (#3543).

has been implemented to reverse the effects of (#3543). The history file can now be specified by setting the fish_history variable (#102).

variable (#102). Read history is now controlled by the fish_history variable rather than the --mode-name flag (#1504).

variable rather than the flag (#1504). Implement a cdh (change directory using recent history) command to provide a more friendly alternative to prevd/nextd and pushd/popd (#2847).

(change directory using recent history) command to provide a more friendly alternative to prevd/nextd and pushd/popd (#2847). command now supports a -a flag to report all directories with the command. This means that which -a $cmd is no longer necessary (#2778).

now supports a flag to report all directories with the command. This means that is no longer necessary (#2778). --init-command / -C added to the command line switches, to allow execution of commands before starting the interactive shell (#4164).

/ added to the command line switches, to allow execution of commands before starting the interactive shell (#4164). set has a new --show option to show lots of information about variables (#4265).

Other significant changes

complete 's --no-files option works as intended (#112).

's option works as intended (#112). pushd +1 works as documented again (#4091).

works as documented again (#4091). Improved completions for killall (#4052), ln (#4090) and zypper (#4079).

(#4052), (#4090) and (#4079). Implemented string lower and string upper (#4080).

and (#4080). help can now open the tutorial.

can now open the tutorial. echo -h now correctly echoes -h (#4120).

now correctly echoes (#4120). Stop converting empty elements in MANPATH to "." (#4158). The behavior being changed was introduced in fish 2.6.0.

count -h and count --help now return one rather than produce command help output (#4189).

and now return one rather than produce command help output (#4189). Fix setting $COLUMNS and $LINES before first prompt is displayed (#4141).

and before first prompt is displayed (#4141). read failures due to too much data should define the var (#4180).

failures due to too much data should define the var (#4180). multiple read commands in non-interactive scripts were broken in fish 2.6.0 (#4206).

commands in non-interactive scripts were broken in fish 2.6.0 (#4206). Fix regression involving universal variables with side-effects at startup such as set -U fish_escape_delay_ms 10 (#4196).

(#4196). Option completion for apt list now works properly (#4350).

now works properly (#4350). Added completions for:

as (#4130)

(#4130) cdh (#2847)

(#2847) dhcpd

ezjail-admin (#4324)

(#4324) fab (fabric, #4153)

(fabric, #4153) grub-file (#4119)

(#4119) grub-install (#4119)

(#4119) jest (#4142)

(#4142) kdeconnect-cli

magneto (#4043, #4108)

(#4043, #4108) mdadm (#4198)

(#4198) s3cmd (#4332)

(#4332) sbt (#4347)

(#4347) snap (#4215)

(#4215) subl (Sublime Text 3 editor, #4277)

(Sublime Text 3 editor, #4277) Improved completions for:

apt

cd (#4061)

(#4061) composer (#4295)

(#4295) flatpak (#4456)

(#4456) git (#4117, #4147, #4329, #4368)

(#4117, #4147, #4329, #4368) gphoto2

killall (#4052)

(#4052) ln

npm (#4241)

(#4241) ssh (#4377)

(#4377) tail

xdg-mime (#4333)

(#4333) zypper (#4325)

Release Notes for fish 2.6.0 (released June 3, 2017)

Notable fixes and improvements

Jobs running in the background can now be removed from the list of jobs with the new disown builtin, which behaves like the same command in other shells (#2810).

builtin, which behaves like the same command in other shells (#2810). Command substitutions now have access to the terminal, like in other shells. This allows tools like fzf to work properly (#1362, #3922).

to work properly (#1362, #3922). In cases where the operating system does not report the size of the terminal, the COLUMNS and LINES environment variables are used; if they are unset, a default of 80x24 is assumed.

and environment variables are used; if they are unset, a default of 80x24 is assumed. New French (#3772 & #3788) and improved German (#3834) translations.

fish no longer depends on the which external command.

Other significant changes

Performance improvements in launching processes, including major reductions in signal blocking. Although this has been heavily tested, it may cause problems in some circumstances; set the FISH_NO_SIGNAL_BLOCK variable to 0 in your fish configuration file to return to the old behaviour (#2007).

variable to 0 in your fish configuration file to return to the old behaviour (#2007). Performance improvements in prompts and functions that set lots of colours (#3793).

The Delete key no longer deletes backwards (a regression in 2.5.0).

functions supports a new --details option, which identifies where the function was loaded from (#3295), and a --details --verbose option which includes the function description (#597).

supports a new option, which identifies where the function was loaded from (#3295), and a option which includes the function description (#597). read will read up to 10 MiB by default, leaving the target variable empty and exiting with status 122 if the line is too long. You can set a different limit with the FISH_READ_BYTE_LIMIT variable.

will read up to 10 MiB by default, leaving the target variable empty and exiting with status 122 if the line is too long. You can set a different limit with the variable. read supports a new --silent option to hide the characters typed (#838), for when reading sensitive data from the terminal. read also now accepts simple strings for the prompt (rather than scripts) with the new -P and --prompt-str options (#802).

supports a new option to hide the characters typed (#838), for when reading sensitive data from the terminal. also now accepts simple strings for the prompt (rather than scripts) with the new and options (#802). export and setenv now understand colon-separated PATH , CDPATH and MANPATH variables.

and now understand colon-separated , and variables. bind supports a new --list-modes option (#3872).

supports a new option (#3872). bg will check all of its arguments before backgrounding any jobs; any invalid arguments will cause a failure, but non-existent (eg recently exited) jobs are ignored (#3909).

will check all of its arguments before backgrounding any jobs; any invalid arguments will cause a failure, but non-existent (eg recently exited) jobs are ignored (#3909). funced warns if the function being edited has not been modified (#3961).

warns if the function being edited has not been modified (#3961). printf correctly outputs "long long" integers (#3352).

correctly outputs "long long" integers (#3352). status supports a new current-function subcommand to print the current function name (#1743).

supports a new subcommand to print the current function name (#1743). string supports a new repeat subcommand (#3864). string match supports a new --entire option to emit the entire line matched by a pattern (#3957). string replace supports a new --filter option to only emit lines which underwent a replacement (#3348).

supports a new subcommand (#3864). supports a new option to emit the entire line matched by a pattern (#3957). supports a new option to only emit lines which underwent a replacement (#3348). test supports the -k option to test for sticky bits (#733).

supports the option to test for sticky bits (#733). umask understands symbolic modes (#738).

understands symbolic modes (#738). Empty components in the CDPATH , MANPATH and PATH variables are now converted to "." (#2106, #3914).

, and variables are now converted to "." (#2106, #3914). New versions of ncurses (6.0 and up) wipe terminal scrollback buffers with certain commands; the C-l binding tries to avoid this (#2855).

binding tries to avoid this (#2855). Some systems' su implementations do not set the USER environment variable; it is now reset for root users (#3916).

implementations do not set the environment variable; it is now reset for root users (#3916). Under terminals which support it, bracketed paste is enabled, escaping problematic characters for security and convience (#3871). Inside single quotes ( ' ), single quotes and backslashes in pasted text are escaped (#967). The fish_clipboard_paste function (bound to C-v by default) is still the recommended pasting method where possible as it includes this functionality and more.

), single quotes and backslashes in pasted text are escaped (#967). The function (bound to by default) is still the recommended pasting method where possible as it includes this functionality and more. Processes in pipelines are no longer signalled as soon as one command in the pipeline has completed (#1926). This behaviour matches other shells mre closely.

All functions requiring Python work with whichever version of Python is installed (#3970). Python 3 is preferred, but Python 2.6 remains the minimum version required.

The color of the cancellation character can be controlled by the fish_color_cancel variable (#3963).

variable (#3963). Added completions for:

caddy (#4008)

(#4008) castnow (#3744)

(#3744) climate (#3760)

(#3760) flatpak

gradle (#3859)

(#3859) gsettings (#4001)

(#4001) helm (#3829)

(#3829) i3-msg (#3787)

(#3787) ipset (#3924)

(#3924) jq (#3804)

(#3804) light (#3752)

(#3752) minikube (#3778)

(#3778) mocha (#3828)

(#3828) mkdosfs (#4017)

(#4017) pv (#3773)

(#3773) setsid (#3791)

(#3791) terraform (#3960)

(#3960) usermod (#3775)

(#3775) xinput

yarn (#3816)

(#3816) Improved completions for adb (#3853), apt (#3771), bzr (#3769), dconf , git (including #3743), grep (#3789), go (#3789), help (#3789), hg (#3975), htop (#3789), killall (#3996), lua , man (#3762), mount (#3764 & #3841), obnam (#3924), perl (#3856), portmaster (#3950), python (#3840), ssh (#3781), scp (#3781), systemctl (#3757) and udisks (#3764).

Release Notes for fish 2.5.0 (released February 3, 2017)

The Home, End, Insert, Delete, Page Up and Page Down keys work in Vi-style key bindings (#3731).

Platform Changes

Linux

Red Hat Enterprise Linux and CentOS 5 & 6 for 64-bit builds

Ubuntu 12.04 (EoLTS April 2017)

Debian 7 (EoLTS May 2018)

OS X SnowLeopard

dyld: Library not loaded: /usr/lib/libc++.1.dylib

Other significant changes

Attempting to exit with running processes in the background produces a warning, then signals them to terminate if a second attempt to exit is made. This brings the behaviour for running background processes into line with stopped processes. (#3497)

random can now have start, stop and step values specified, or the new choice subcommand can be used to pick an argument from a list (#3619).

can now have start, stop and step values specified, or the new subcommand can be used to pick an argument from a list (#3619). A new key bindings preset, fish_hybrid_key_bindings , including all the Emacs-style and Vi-style bindings, which behaves like fish_vi_key_bindings in fish 2.3.0 (#3556).

, including all the Emacs-style and Vi-style bindings, which behaves like in fish 2.3.0 (#3556). function now returns an error when called with invalid options, rather than defining the function anyway (#3574). This was a regression present in fish 2.3 and 2.4.0.

now returns an error when called with invalid options, rather than defining the function anyway (#3574). This was a regression present in fish 2.3 and 2.4.0. fish no longer prints a warning when it identifies a running instance of an old version (2.1.0 and earlier). Changes to universal variables may not propagate between these old versions and 2.5b1.

Improved compatiblity with Android (#3585), MSYS/mingw (#2360), Solaris (#3456, #3340)

Like other shells, the test builting now returns an error for numeric operations on invalid integers (#3346, #3581).

builting now returns an error for numeric operations on invalid integers (#3346, #3581). complete no longer recognises --authoritative and --unauthoritative options, and they are marked as obsolete.

no longer recognises and options, and they are marked as obsolete. status accepts subcommands, and should be used like status is-interactive . The old options continue to be supported for the foreseeable future (#3526), although only one subcommand or option can be specified at a time.

accepts subcommands, and should be used like . The old options continue to be supported for the foreseeable future (#3526), although only one subcommand or option can be specified at a time. Selection mode (used with "begin-selection") no longer selects a character the cursor does not move over (#3684).

List indexes are handled better, and a bit more liberally in some cases ( echo $PATH[1 .. 3] is now valid) (#3579).

is now valid) (#3579). The fish_mode_prompt function is now simply a stub around fish_default_mode_prompt , which allows the mode prompt to be included more easily in customised prompt functions (#3641).

Notable fixes and improvements

alias , run without options or arguments, lists all defined aliases, and aliases now include a description in the function signature that identifies them.

, run without options or arguments, lists all defined aliases, and aliases now include a description in the function signature that identifies them. complete accepts empty strings as descriptions (#3557).

accepts empty strings as descriptions (#3557). command accepts -q / --quiet in combination with --search (#3591), providing a simple way of checking whether a command exists in scripts.

accepts / in combination with (#3591), providing a simple way of checking whether a command exists in scripts. Abbreviations can now be renamed with abbr --rename OLD_KEY NEW_KEY (#3610).

(#3610). The command synopses printed by --help options work better with copying and pasting (#2673).

options work better with copying and pasting (#2673). help launches the browser specified by the $fish_help_browser variable if it is set (#3131).

launches the browser specified by the if it is set (#3131). History merging could lose items under certain circumstances and is now fixed (#3496).

The $status variable is now set to 123 when a syntactically invalid command is entered (#3616).

variable is now set to 123 when a syntactically invalid command is entered (#3616). Exiting fish now signals all background processes to terminate, not just stopped jobs (#3497).

A new prompt_hostname function which prints a hostname suitable for use in prompts (#3482).

function which prints a hostname suitable for use in prompts (#3482). The __fish_man_page function (bound to Alt-h by default) now tries to recognize subcommands (e.g. git add will now open the "git-add" man page) (#3678).

function (bound to Alt-h by default) now tries to recognize subcommands (e.g. will now open the "git-add" man page) (#3678). A new function edit_command_buffer (bound to Alt-e & Alt-v by default) to edit the command buffer in an external editor (#1215, #3627).

(bound to Alt-e & Alt-v by default) to edit the command buffer in an external editor (#1215, #3627). set_color now supports italics ( --italics ), dim ( --dim ) and reverse ( --reverse ) modes (#3650).

now supports italics ( ), dim ( ) and reverse ( ) modes (#3650). Filesystems with very slow locking (eg incorrectly-configured NFS) will no longer slow fish down (#685).

Improved completions for apt (#3695), fusermount (#3642), make (#3628), netctl-auto (#3378), nmcli (#3648), pygmentize (#3378), and tar (#3719).

(#3695), (#3642), (#3628), (#3378), (#3648), (#3378), and (#3719). Added completions for:

VBoxHeadless (#3378)

(#3378) VBoxSDL (#3378)

(#3378) base64 (#3378)

(#3378) caffeinate (#3524)

(#3524) dconf (#3638)

(#3638) dig (#3495)

(#3495) dpkg-reconfigure (#3521 & #3522)

(#3521 & #3522) feh (#3378)

(#3378) launchctl (#3682)

(#3682) lxc (#3554 & #3564),

(#3554 & #3564), mddiagnose (#3524)

(#3524) mdfind (#3524)

(#3524) mdimport (#3524)

(#3524) mdls (#3524)

(#3524) mdutil (#3524)

(#3524) mkvextract (#3492)

(#3492) nvram (#3524)

(#3524) objdump (#3378)

(#3378) sysbench (#3491)

(#3491) tmutil (#3524)

Release Notes for fish 2.4.0 (released November 8, 2016)

Significant changes

The clipboard integration has been revamped with explicit bindings. The killring commands no longer copy from, or paste to, the X11 clipboard - use the new copy ( C-x ) and paste ( C-v ) bindings instead. The clipboard is now available on OS X as well as systems using X11 (e.g. Linux). (#3061)

) and paste ( ) bindings instead. The clipboard is now available on OS X as well as systems using X11 (e.g. Linux). (#3061) history uses subcommands ( history delete ) rather than options ( history --delete ) for its actions (#3367). You can no longer specify multiple actions via flags (e.g., history --delete --save something ).

uses subcommands ( ) rather than options ( ) for its actions (#3367). You can no longer specify multiple actions via flags (e.g., ). New history options have been added, including --max=n to limit the number of history entries, --show-time option to show timestamps (#3175, #3244), and --null to null terminate history entries in the search output.

options have been added, including to limit the number of history entries, option to show timestamps (#3175, #3244), and to null terminate history entries in the search output. history search is now case-insensitive by default (which also affects history delete ) (#3236).

is now case-insensitive by default (which also affects ) (#3236). history delete now correctly handles multiline commands (#31).

now correctly handles multiline commands (#31). Vi-style bindings no longer include all of the default emacs-style bindings; instead, they share some definitions (#3068).

If there is no locale set in the environment, various known system configuration files will be checked for a default. If no locale can be found, en_US-UTF.8 will be used (#277).

will be used (#277). A number followed by a caret (e.g. 5^ ) is no longer treated as a redirection (#1873).

) is no longer treated as a redirection (#1873). The $version special variable can be overwritten, so that it can be used for other purposes if required.

Notable fixes and improvements

The fish_realpath builtin has been renamed to realpath and made compatible with GNU realpath when run without arguments (#3400). It is used only for systems without a realpath or grealpath utility (#3374).

builtin has been renamed to and made compatible with GNU when run without arguments (#3400). It is used only for systems without a or utility (#3374). Improved color handling on terminals/consoles with 8-16 colors, particularly the use of bright named color (#3176, #3260).

fish_indent can now read from files given as arguments, rather than just standard input (#3037).

can now read from files given as arguments, rather than just standard input (#3037). Fuzzy tab completions behave in a less surprising manner (#3090, #3211).

jobs should only print its header line once (#3127).

should only print its header line once (#3127). Wildcards in redirections are highlighted appropriately (#2789).

Suggestions will be offered more often, like after removing characters (#3069).

history --merge now correctly interleaves items in chronological order (#2312).

now correctly interleaves items in chronological order (#2312). Options for fish_indent have been aligned with the other binaries - in particular, -d now means --debug . The --dump option has been renamed to --dump-parse-tree (#3191).

have been aligned with the other binaries - in particular, now means . The option has been renamed to (#3191). The display of bindings in the Web-based configuration has been greatly improved (#3325), as has the rendering of prompts (#2924).

fish should no longer hang using 100% CPU in the C locale (#3214).

A bug in FreeBSD 11 & 12, Dragonfly BSD & illumos prevented fish from working correctly on these platforms under UTF-8 locales; fish now avoids the buggy behaviour (#3050).

Prompts which show git repository information (via __fish_git_prompt ) are faster in large repositories (#3294) and slow filesystems (#3083).

) are faster in large repositories (#3294) and slow filesystems (#3083). fish 2.3.0 reintroduced a problem where the greeting was printed even when using read ; this has been corrected again (#3261).

; this has been corrected again (#3261). Vi mode changes the cursor depending on the current mode (#3215).

Command lines with escaped space characters at the end tab-complete correctly (#2447).

Added completions for:

arcanist (#3256)

(#3256)

connmanctl (#3419)

(#3419)

figlet (#3378)

(#3378)

mdbook (#3378)

(#3378)

ninja (#3415)

(#3415)

p4 , the Perforce client (#3314)

, the Perforce client (#3314)

pygmentize (#3378)

(#3378)

ranger (#3378)

(#3378) Improved completions for aura (#3297), abbr (#3267), brew (#3309), chown (#3380, #3383), cygport (#3392), git (#3274, #3226, #3225, #3094, #3087, #3035, #3021, #2982, #3230), kill & pkill (#3200), screen (#3271), wget (#3470), and xz (#3378).

(#3297), (#3267), (#3309), (#3380, #3383), (#3392), (#3274, #3226, #3225, #3094, #3087, #3035, #3021, #2982, #3230), pkill screen wget xz Distributors, packagers and developers will notice that the build process produces more succinct output by default; use make V=1 to get verbose output (#3248).

to get verbose output (#3248). Improved compatibility with minor platforms including musl (#2988), Cygwin (#2993), Android (#3441, #3442), Haiku (#3322) and Solaris.

Automatic cursor changes are now only enabled on the subset of XTerm versions known to support them, resolving a problem where older versions printed garbage to the terminal before and after every prompt (#3499).

Improved the title set in Apple Terminal.app.

Added completions for defaults and improved completions for diskutil (#3478).

Release Notes for fish 2.3.1 (released July 3, 2016)

Significant changes

A new fish_key_reader binary for decoding interactive keypresses (#2991).

binary for decoding interactive keypresses (#2991). fish_mode_prompt has been updated to reflect the changes in the way the Vi input mode is set up (#3067), making this more reliable.

has been updated to reflect the changes in the way the Vi input mode is set up (#3067), making this more reliable. fish_config can now properly be launched from the OS X app bundle (#3140).

Notable fixes and improvements

Extra lines were sometimes inserted into the output under Windows (Cygwin and Microsoft Windows Subsystem for Linux) due to TTY timestamps not being updated (#2859).

The string builtin's match mode now handles the combination of -rnv (match, invert and count) correctly (#3098).

builtin's mode now handles the combination of (match, invert and count) correctly (#3098). Improvements to TTY special character handling (#3064), locale handling (#3124) and terminal environment variable handling (#3060).

Work towards handling the terminal modes for external commands launched from initialisation files (#2980).

Ease the upgrade path from fish 2.2.0 and before by warning users to restart fish if the string builtin is not available (#3057).

builtin is not available (#3057). type -a now syntax-colorizes function source output.

now syntax-colorizes function source output. Added completions for alsamixer , godoc , gofmt , goimports , gorename , lscpu , mkdir , modinfo , netctl-auto , poweroff , termite , udisksctl and xz (#3123).

, , , , , , , , , , , and (#3123). Improved completions for apt (#3097), aura (#3102), git (#3114), npm (#3158), string and suspend (#3154).

Release Notes for fish 2.3.0 (released May 20, 2016)

Significant Changes

A new string builtin to handle… strings! This builtin will measure, split, search and replace text strings, including using regular expressions. It can also be used to turn lists into plain strings using join. string can be used in place of sed, grep, tr, cut, and awk in many situations. (#2296)

builtin to handle… strings! This builtin will measure, split, search and replace text strings, including using regular expressions. It can also be used to turn lists into plain strings using join. string can be used in place of sed, grep, tr, cut, and awk in many situations. (#2296) After seeing an escape character wait up to 300ms for an additional character. This is consistent with readline (e.g. bash) and can be configured via the fish_escape_delay_ms variable. This allows using escape as the Meta modifier. (#1356)

Add new directories for vendor functions and configuration snippets (#2498)

A new fish_realpath builtin and associated function to allow the use of realpath even on those platforms that don't ship an appropriate command. (#2932)

Alt-# toggles the current command line between commented and uncommented states, making it easy to save a command in history without executing it.

The fish_vi_mode function is now deprecated in favour of fish_vi_key_bindings

Backward-incompatible changes

Unmatched globs will now cause an error, except when used with for , set or count (#2719, #2394)

, or (#2719, #2394) and and or will now bind to the closest if or while , allowing compound conditions without begin and end (#1428)

and will now bind to the closest or , allowing compound conditions without and (#1428) set -ql now searches up to function scope for variables (#2502)

now searches up to function scope for variables (#2502) status -f will now behave the same when run as the main script or using source (#2643)

will now behave the same when run as the main script or using (#2643) source no longer puts the file name in $argv if no arguments are given (#139)

Other Notable Fixes and Improvements

Fish no longer silences errors in config.fish (#2702)

Move the history file to $XDG_DATA_HOME/fish (or ~/.local/share if it has not been set)

Directory autosuggestions will now descend as far as possible if there is only one child directory (#2531)

Add support for bright colors (#1464)

Allow Ctrl-J (\cj) to be bound separately from Ctrl-M (\cm) (#217)

psub now has a "-s"/"-suffix" option to name the temporary file with that suffix

Enable 24-bit colors on select terminals (#2495)

Support for SVN status in the prompt (#2582)

Mercurial and SVN support have been added to the Classic + Git (now Classic + VCS) prompt (via the new __fish_vcs_prompt function) (#2592)

export now handles variables with a "=" in the value (#2403)

now handles variables with a "=" in the value (#2403) Avoid confusing the terminal line driver with non-printing characters in fish_title (#2453)

(#2453) New completions for: alsactl Archlinux’s asp, makepkg Atom’s apm (#2390) entr - the "Event Notify Test Runner" (#2265) Fedora’s dnf (#2638) OSX diskutil (#2738) pkgng (#2395) pulseaudio’s pacmd and pactl rmmod (#3007) rust’s rustc and cargo (#2409) sysctl (#2214) systemd’s machinectl (#2158), busctl (#2144), systemd-nspawn, systemd-analyze, localectl, timedatectl and more

Fish no longer has a function called sgrep, freeing it for user customization (#2245)

A rewrite of the completions for cd, fixing a few bugs (#2299, #2300, #562)

Linux VTs now run in a simplified mode to avoid issues (#2311)

The vi-bindings now inherit from the emacs bindings

Fish will also execute fish_user_key_bindings when in vi-mode

funced will now also check $VISUAL (#2268)

will now also check $VISUAL (#2268) A new suspend function (#2269)

function (#2269) Subcommand completion now works better with split /usr (#2141)

The command-not-found-handler can now be overridden by defining a function called __fish_command_not_found_handler in config.fish (#2331)

in config.fish (#2331) A few fixes to the Sorin theme

PWD shortening in the prompt can now be configured via the fish_prompt_pwd_dir_length variable, set to the length per path component (#2473)

fish now ships a skeleton file for /etc/fish/config.fish that only contains some documentation, the included code has been moved to the corresponding file in /usr (#2799)

Release Notes for fish 2.2.0 (released July 12, 2015)

Significant Changes

Abbreviations: the new `abbr` command allows for interactively-expanded abbreviations, allowing quick access to frequently-used commands (#731).

Vi mode: run `fish_vi_mode` to switch fish into the key bindings and prompt familiar to users of the Vi editor (#65).

New inline and interactive pager, which will be familiar to users of zsh (#291).

Underlying architectural changes: the `fishd` universal variable server has been removed as it was a source of many bugs and security problems. Notably, old fish sessions will not be able to communicate universal variable changes with new fish sessions. For best results, restart all running instances of `fish`.

The web-based configuration tool has been redesigned, featuring a prompt theme chooser and other improvements.

New German, Brazilian Portuguese, and Chinese translations.

Backward-incompatible changes

`commandline` no longer interprets functions "in reverse", instead behaving as expected (#1567).

The previously-undocumented `CMD_DURATION` variable is now set for all commands and contains the execution time of the last command in milliseconds (#1585). It is no longer exported to other commands (#1896).

`if` / `else` conditional statements now return values consistent with the Single Unix Specification, like other shells (#1443).

A new "top-level" local scope has been added, allowing local variables declared on the commandline to be visible to subsequent commands. (#206)

Other notable fixes and improvements

New documentation design (#1662), which requires a Doxygen version 1.8.7 or newer to build.

Fish now defines a default directory for other packages to provide completions. By default this is `/usr/share/fish/vendor-completions.d`; on systems with `pkgconfig` installed this path is discoverable with `pkg-config --variable completionsdir fish`.

A new parser removes many bugs; all existing syntax should keep working.

New `fish_preexec` and `fish_postexec` events are fired before and after job execution respectively (#1549).

Unmatched wildcards no longer prevent a job from running. Wildcards used interactively will still print an error, but the job will proceed and the wildcard will expand to zero arguments (#1482).

The `.` command is deprecated and the `source` command is preferred (#310).

`bind` supports "bind modes", which allows bindings to be set for a particular named mode, to support the implementation of Vi mode.

A new `export` alias, which behaves like other shells (#1833).

`command` has a new `--search` option to print the name of the disk file that would be executed, like other shells' `command -v` (#1540).

`commandline` has a new `--paging-mode` option to support the new pager.

`complete` has a new `--wraps` option, which allows a command to (recursively) inherit the completions of a wrapped command (#393), and `complete -e` now correctly erases completions (#380).

Completions are now generated from manual pages by default on the first run of fish (#997).

`fish_indent` can now produce colorized (`--ansi`) and HTML (`--html`) output (#1827).

`functions --erase` now prevents autoloaded functions from being reloaded in the current session.

`history` has a new `--merge` option, to incorporate history from other sessions into the current session (#825).

`jobs` returns 1 if there are no active jobs (#1484).

`read` has several new options: `--array` to break input into an array (#1540) `--null` to break lines on NUL characters rather than newlines (#1694) `--nchars` to read a specific number of characters (#1616) `--right-prompt` to display a right-hand-side prompt during interactive read (#1698).

`type` has a new `-q` option to suppress output (#1540 and, like other shells, `type -a` now prints all matches for a command (#261).

Pressing F1 now shows the manual page for the current command (#1063).

`fish_title` functions have access to the arguments of the currently running argument as `$argv[1]` (#1542).

The OS command-not-found handler is used on Arch Linux (#1925), nixOS (#1852), openSUSE and Fedora (#1280).

`Alt`+`.` searches backwards in the token history, mapping to the same behavior as inserting the last argument of the previous command, like other shells (#89).

The `SHLVL` environment variable is incremented correctly (#1634 & #1693).

Added completions for `adb` (#1165 & #1211), `apt` (#2018), `aura` (#1292), `composer` (#1607), `cygport` (#1841), `dropbox` (#1533), `elixir` (#1167), `fossil`, `heroku` (#1790), `iex` (#1167), `kitchen` (#2000), `nix` (#1167), `node`/`npm` (#1566), `opam` (#1615), `setfacl` (#1752), `tmuxinator` (#1863), and `yast2` (#1739).

Improved completions for `brew` (#1090 & #1810), `bundler` (#1779), `cd` (#1135), `emerge` (#1840),`git` (#1680, #1834 & #1951), `man` (#960), `modprobe` (#1124), `pacman` (#1292), `rpm` (#1236), `rsync` (#1872), `scp` (#1145), `ssh` (#1234), `sshfs` (#1268), `systemctl` (#1462, #1950 & #1972), `tmux` (#1853), `vagrant` (#1748), `yum` (#1269), and `zypper` (#1787).

Release Notes for fish 2.1.2 (released Feb 24, 2015)

fish 2.1.2 contains a workaround for a filesystem bug in Mac OS X Yosemite. #1859

Specifically, after installing fish 2.1.1 and then rebooting, "Verify Disk" in Disk Utility will report "Invalid number of hard links." We don't have any reports of data loss or other adverse consequences. fish 2.1.2 avoids triggering the bug, but does not repair an already affected filesystem. To repair the filesystem, you can boot into Recovery Mode and use Repair Disk from Disk Utility. Linux and versions of OS X prior to Yosemite are believed to be unaffected.

There are no other changes in this release.

Release Notes for fish 2.1.1 (released September 26, 2014)

Important: if you are upgrading, stop all running instances of fishd as soon as possible after installing this release; it will be restarted automatically. On most systems, there will be no further action required. Note that some environments (where XDG_RUNTIME_DIR is set), such as Fedora 20, will require a restart of all running fish processes before universal variables work as intended.

Distributors are highly encouraged to call killall fishd , pkill fishd or similar in installation scripts, or to warn their users to do so.

Security fixes

The fish_config web interface now uses an authentication token to protect requests and only responds to requests from the local machine with this token, preventing a remote code execution attack. (closing CVE-2014-2914). #1438

psub and funced are no longer vulnerable to attacks which allow local privilege escalation and data tampering (closing CVE-2014-2906 and CVE-2014-3856). #1437

and are no longer vulnerable to attacks which allow local privilege escalation and data tampering (closing CVE-2014-2906 and CVE-2014-3856). #1437 fishd uses a secure path for its socket, preventing a local privilege escalation attack (closing CVE-2014-2905). #1436

uses a secure path for its socket, preventing a local privilege escalation attack (closing CVE-2014-2905). #1436 __fish_print_packages is no longer vulnerable to attacks which would allow local privilege escalation and data tampering (closing CVE-2014-3219). #1440

Other fixes

fishd now ignores SIGPIPE, fixing crashes using tools like GNU Parallel and which occurred more often as a result of the other fishd changes. #1084 & #1690

Release Notes for fish 2.1.0 (released October 28, 2013)

Significant Changes

Tab completions will fuzzy-match files. #568 When tab-completing a file, fish will first attempt prefix matches ( foo matches foobar ), then substring matches ( ooba matches foobar ), and lastly subsequence matches ( fbr matches foobar ). For example, in a directory with files foo1.txt, foo2.txt, foo3.txt…, you can type only the numeric part and hit tab to fill in the rest. This feature is implemented for files and executables. It is not yet implemented for options (like --foobar ), and not yet implemented across path components (like /u/l/b to match /usr/local/bin ).

#568 Redirections now work better across pipelines. #110, #877 In particular, you can pipe stderr and stdout together, for example, with cmd ^&1 | tee log.txt , or the more familiar cmd 2>&1 | tee log.txt

#110, #877 A single % now expands to the last job backgrounded. #1008 Previously, a single % would pid-expand to either all backgrounded jobs, or all jobs owned by your user. Now it expands to the last job backgrounded. If no job is in the background, it will fail to expand. In particular, fg % can be used to put the most recent background job in the foreground.

Other Notable Fixes

alt-U and alt+C now uppercase and capitalize words, respectively. #995

VTE based terminals should now know the working directory. #906

The autotools build now works on Mavericks. #968

The end-of-line binding (ctrl+E) now accepts autosuggestions. #932

Directories in /etc/paths (used on OS X) are now prepended instead of appended, similar to other shells. #927

(used on OS X) are now prepended instead of appended, similar to other shells. #927 Option-right-arrow (used for partial autosuggestion completion) now works on iTerm2. #920

Tab completions now work properly within nested subcommands. #913

printf supports \e, the escape character. #910

supports \e, the escape character. #910 fish_config history no longer shows duplicate items. #900

no longer shows duplicate items. #900 $fish_user_paths is now prepended to $PATH instead of appended. #888

is now prepended to instead of appended. #888 Jobs complete when all processes complete. #876 For example, in previous versions of fish, ' sleep 10 | echo Done ' returns control immediately, because echo does not read from stdin. Now it does not complete until sleep exits (presumably after 10 seconds).

Better error reporting for square brackets. #875

fish no longer tries to add /bin to $PATH unless PATH is totally empty. #852

to unless PATH is totally empty. #852 History token substitution (alt-up) now works correctly inside subshells. #833

Flow control is now disabled, freeing up ctrl-S and ctrl-Q for other uses. #814

sh-style variable setting like foo=bar now produces better error messages. #809

now produces better error messages. #809 Commands with wildcards no longer produce autosuggestions. #785

funced no longer freaks out when supplied with no arguments. #780

no longer freaks out when supplied with no arguments. #780 fish.app now works correctly in a directory containing spaces. #774

now works correctly in a directory containing spaces. #774 Tab completion cycling no longer occasionally fails to repaint. #765

Comments now work in eval'd strings. #684

History search (up-arrow) now shows the item matching the autosuggestion, if that autosuggestion was truncated. #650

Ctrl-T now transposes characters, as in other shells. #128

Release Notes for fish 2.0.0 (released May 17, 2013)

Significant Changes

Command substitutions now modify $status #547. Previously the exit status of command substitutions (like (pwd) ) was ignored; however now it modifies $status. Furthermore, the set command now only sets $status on failure; it is untouched on success. This allows for the following pattern: if set python_path (which python) ... end Because set does not modify $status on success, the if branch effectively tests whether which succeeded, and if so, whether the set also succeeded.

#547. Because set does not modify $status on success, the if branch effectively tests whether succeeded, and if so, whether the also succeeded. Improvements to $PATH handling . There is a new variable, $fish_user_paths , which can be set universally, and whose contents are appended to $PATH #527 /etc/paths and /etc/paths.d are now respected on OS X fish no longer modifies $PATH to find its own binaries

. Long lines no longer use ellipsis for line breaks , and copy and paste should no longer include a newline even if the line was broken #300

, and copy and paste should no longer include a newline even if the line was broken #300 New syntax for index ranges (sometimes known as "slices") #212

(sometimes known as "slices") #212 fish now supports an else if statement #134

#134 Process and pid completion now works on OS X #129

#129 fish is now relocatable , and no longer depends on compiled-in paths #125

, and no longer depends on compiled-in paths #125 fish now supports a right prompt (RPROMPT) through the fish_right_prompt function #80

through the function #80 fish now uses posix_spawn instead of fork when possible, which is much faster on BSD and OS X #11

Other Notable Fixes

Updated VCS completions (darcs, cvs, svn, etc.)

Avoid calling getcwd on the main thread, as it can hang #696

Control-D (forward delete) no longer stops at a period #667

Completions for many new commands

fish now respects rxvt's unique keybindings #657

xsel is no longer built as part of fish. It will still be invoked if installed separately #633

__fish_filter_mime no longer spews #628

The --no-execute option to fish no longer falls over when reaching the end of a block #624

fish_config knows how to find fish even if it's not in the $PATH #621

A leading space now prevents writing to history, as is done in bash and zsh #615

Hitting enter after a backslash only goes to a new line if it is followed by whitespace or the end of the line #613

printf is now a builtin #611

Event handlers should no longer fire if signals are blocked #608

set_color is now a builtin #578

man page completions are now located in a new generated_completions directory, instead of your completions directory #576

tab now clears autosuggestions #561

tab completion from within a pair of quotes now attempts to "appropriate" the closing quote #552

$EDITOR can now be a list: for example, set EDITOR gvim -f ) #541

) #541 case bodies are now indented #530

bodies are now indented #530 The profile switch -p no longer crashes #517

no longer crashes #517 You can now control-C out of read #516

#516 umask is now functional on OS X #515

is now functional on OS X #515 Avoid calling getpwnam on the main thread, as it can hang #512

Alt-F or Alt-right-arrow (Option-F or option-right-arrow) now accepts one word of an autosuggestion #435

Setting fish as your login shell no longer kills OpenSUSE #367

Backslashes now join lines, instead of creating multiple commands #347

echo now implements the -e flag to interpret escapes #337

When the last token in the user's input contains capital letters, use its case in preference to that of the autosuggestion #335

Descriptions now have their own muted color #279

Wildcards beginning with a . (for example, ls .* ) no longer match . and .. #270

) no longer match . and .. #270 Recursive wildcards now handle symlink loops #268

You can now delete history items from the fish_config web interface #250

The OS X build now weak links wcsdup and wcscasecmp #240

and #240 fish now saves and restores the process group, which prevents certain processes from being erroneously reported as stopped #197

funced now takes an editor option #187

now takes an editor option #187 Alternating row colors are available in fish pager through fish_pager_color_secondary #186

#186 Universal variable values are now stored based on your MAC address, not your hostname #183

The caret ^ now only does a stderr redirection if it is the first character of a token, making git users happy #168

Autosuggestions will no longer cause line wrapping #167

Better handling of Unicode combining characters #155

fish SIGHUPs processes more often #138

fish no longer causes sudo to ask for a password every time

to ask f