Releases: fish-shell/fish-shell
fish 3.4.0 (released March 12, 2022)
Notable improvements and fixes
- fish’s command substitution syntax has been extended:
$(cmd)
now has the same meaning as(cmd)
but it can be used inside double quotes, to prevent line splitting of the results (#159):
foo (bar | string collect)
# can now be written as
foo "$(bar)"
# and
foo (bar)
# can now be written as
foo $(bar)
# this will still split on newlines only.
- Complementing the
prompt
command in 3.3.0,fish_config
gained atheme
subcommand to show and pick from the sample themes (meaning color schemes) directly in the terminal, instead of having to open a Web browser. For examplefish_config theme choose Nord
loads the Nord theme in the current session (#8132). The current theme can be saved withfish_config theme dump
, and custom themes can be added by saving them in~/.config/fish/themes/
. set
andread
learned a new option,--function
, to set a variable in the function’s top scope. This should be a more familiar way of scoping variables and avoids issues with--local
, which is actually block-scoped (#565, #8145):
function demonstration
if true
set --function foo bar
set --local baz banana
end
echo $foo # prints "bar" because $foo is still valid
echo $baz # prints nothing because $baz went out of scope
end
string pad
now excludes escape sequences like colors that fish knows about, and a new--visible
flag tostring length
makes it use that kind of visible width. This is useful to get the number of terminal cells an already colored string would occupy, like in a prompt. (#8182, #7784, #4012):
> string length --visible (set_color red)foo
3
- Performance improvements to globbing, especially on systems using glibc. In some cases (large directories with files with many numbers in the names) this almost halves the time taken to expand the glob.
- Autosuggestions can now be turned off by setting
$fish_autosuggestion_enabled
to 0, and (almost) all highlighting can be turned off by choosing the new “None” theme. The exception is necessary colors, like those which distinguish autosuggestions from the actual command line. (#8376) - The
fish_git_prompt
function, which is included in the default prompts, now overridesgit
to avoid running commands set by per-repository configuration. This avoids a potential security issue in some circumstances, and has been assigned CVE-2022-20001 (#8589).
Deprecations and removed features
- A new feature flag,
ampersand-nobg-in-token
makes&
only act as background operator if followed by a separator. In combination withqmark-noglob
, this allows entering most URLs at the command line without quoting or escaping (#7991). For example:
> echo foo&bar # will print "foo&bar", instead of running "echo foo" in the background and executing "bar"
> echo foo & bar # will still run "echo foo" in the background and then run "bar"
# with both ampersand-nobg-in-token and qmark-noglob, this argument has no special characters anymore
> open https://www.youtube.com/watch?v=dQw4w9WgXcQ&feature=youtu.be
As a reminder, feature flags can be set on startup with fish --features ampersand-nobg-in-token,qmark-noglob
or with a universal variable called fish_features
:
> set -Ua fish_features ampersand-nobg-in-token
$status
is now forbidden as a command, to prevent a surprisingly common error among new users: Runningif $status
(#8171). This applies only to$status
, other variables are still allowed.set --query
now returns an exit status of 255 if given no variable names. This meansif set -q $foo
will not enter the if-block if$foo
is empty or unset. To restore the previous behavior, useif not set -q foo; or set -q $foo
- but this is unlikely to be desireable (#8214)._
is now a reserved keyword (#8342).- The special input functions
delete-or-exit
,nextd-or-forward-word
andprevd-or-backward-word
replace fish functions of the same names (#8538). - Mac OS X 10.9 is no longer supported. The minimum Mac version is now 10.10 “Yosemite.”
Scripting improvements
string collect
supports a new--allow-empty
option, which will output one empty argument in a command substitution that has no output (#8054). This allows commands liketest -n (echo -n | string collect --allow-empty)
to work more reliably. Note this can also be written astest -n "$(echo -n)"
(see above).string match
gained a--groups-only
option, which makes it only output capturing groups, excluding the full match. This allowsstring match
to do simple transformations (#6056):
> string match -r --groups-only '(.*)fish' 'catfish' 'twofish' 'blue fish' | string escape
cat
two
'blue '
$fish_user_paths
is now automatically deduplicated to fix a common user error of appending to it in config.fish when it is universal (#8117). fish_add_path remains the recommended way to add to $PATH.return
can now be used outside functions. In scripts, it does the same thing asexit
. In interactive mode,it sets$status
without exiting (#8148).- An oversight prevented all syntax checks from running on commands given to
fish -c
(#8171). This includes checks such asexec
not being allowed in a pipeline, and$$
not being a valid variable. Generally, another error was generated anyway. fish_indent
now correctly reformats tokens that end with a backslash followed by a newline (#8197).commandline
gained an--is-valid
option to check if the command line is syntactically valid and complete. This allows basic implementation of transient prompts (#8142).commandline
gained a--paging-full-mode
option to check if the pager is showing all the possible lines (no “7 more rows” message) (#8485).- List expansion correctly reports an error when used with all zero indexes (#8213).
- Running
fish
with a directory instead of a script as argument (egfish .
) no longer leads to an infinite loop. Instead it errors out immediately (#8258) - Some error messages occuring after fork, like “text file busy” have been replaced by bespoke error messages for fish (like “File is currently open for writing”). This also restores error messages with current glibc versions that removed sys_errlist (#8234, #4183).
- The
realpath
builtin now also squashes leading slashes with the--no-symlinks
option (#8281). - When trying to
cd
to a dangling (broken) symbolic link, fish will print an error noting that the target is a broken link (#8264). - On MacOS terminals that are not granted permissions to access a folder,
cd
would print a spurious “rotten symlink” error, which has been corrected to “permission denied” (#8264). - Since fish 3.0,
for
loops would trigger a variable handler function before the loop was entered. As the variable had not actually changed or been set, this was a spurious event and has been removed (#8384). math
now correctly prints negative values and values larger than2\*\*31
when in hex or octal bases (#8417).dirs
always produces an exit status of 0, instead of sometimes returning 1 (#8211).cd ""
no longer crashes fish (#8147).set --query
can now query whether a variable is a path variable via--path
or--unpath
(#8494).- Tilde characters (
~
) produced by custom completions are no longer escaped when applied to the command line, making it easier to use the output of a recursivecomplete -C
in completion scripts (#4570). set --show
reports when a variable is read-only (#8179).- Erasing
$fish_emoji_width
will reset fish to the default guessed emoji width (#8274). - The
la
function no longer lists entries for “.” and “..”, matching other systems defaults ([#8519](https://github.com/fish-shell/fish-shell/issues...
fish 3.3.1 (released July 6, 2021)
This release of fish fixes the following problems identified in fish 3.3.0:
- The prompt and command line are redrawn correctly in response to universal variable changes (#8088).
- A superfluous error that was produced when setting the
PATH
orCDPATH
environment variables to include colon-delimited components that do not exist was removed (#8095). - The Vi mode indicator in the prompt is repainted correctly after
Ctrl-C
cancels the current command (#8103). - fish builds correctly on platforms that do not have a
spawn.h
header, such as old versions of OS X (#8097).
A number of improvements to the documentation, and fixes for completions, are included as well.
If you are upgrading from version 3.2.2 or before, please also review the release notes for 3.3.0.
Download links: To download the source code for fish, use the file named "fish-3.3.1.tar.xz". The file downloaded from "Source code (tar.gz)" has extra build requirements. The SHA-256 sum of this file is b5b4ee1a5269762cbbe993a4bd6507e675e4100ce9bbe84214a5eeb2b19fae89
. A GPG signature from David Adam (key ID 0x7A67D962D88A709A
) is available as "fish-3.3.1.tar.xz.asc".
fish 3.3.0 (released June 28, 2021)
Notable improvements and fixes
fish_config
gained aprompt
subcommand to show and pick from the sample prompts directly in the terminal, instead of having to open a webbrowser. For examplefish_config prompt choose default
loads the default prompt in the current session (#7958).- The documentation has been reorganized to be easier to understand (#7773).
Deprecations and removed features
- The
$fish_history
value "default" is no longer special. It used to be treated the same as "fish" (#7650). - Redirection to standard error with the
^
character has been disabled by default. It can be turned back on using thestderr-nocaret
feature flag, but will eventually be disabled completely (#7105). - Specifying an initial tab to
fish_config
now only works withfish_config browse
(e.g.fish_config browse variables
), otherwise it would interfere with the newprompt
subcommand (see below) (#7958).
Scripting improvements
math
gained new functionslog2
(like the documentation claimed),max
andmin
(#7856).math
functions can be used without the parentheses (egmath sin 2 + 6
), and functions have the lowest precedence in the order of operations (#7877).- Shebang (
#!
) lines are no longer required within shell scripts, improving support for scripts with concatenated binary contents. If a file fails to execute and passes a (rudimentary) binary safety check, fish will re-invoke it using/bin/sh
(#7802). - Exit codes are better aligned with bash. A failed execution now reports
$status
of 127 if the file is not found, and 126 if it is not executable. echo
no longer writes its output one byte at a time, improving performance and allowing use with Linux's special API files (/proc
,/sys
and such) (#7836).- fish should now better handle
cd
on filesystems with brokenstat(3)
responses (#7577). - Builtins now properly report a
$status
of 1 upon unsuccessful writes (#7857). string match
with unmatched capture groups and without the--all
flag now sets an empty variable instead of a variable containing the empty string. It also correctly imports the first match if multiple arguments are provided, matching the documentation. (#7938).- fish produces more specific errors when a command in a command substitution wasn't found or is not allowed. This now prints something like "Unknown command" instead of "Unknown error while evaluating command substitution".
fish_indent
allows inline variable assignments (FOO=BAR command
) to use line continuation, instead of joining them into one line (#7955).- fish gained a
--no-config
option to disable configuration files. This applies to user-specific and the systemwideconfig.fish
(typically in/etc/fish/config.fish
), and configuration snippets (typically inconf.d
directories). It also disables universal variables, history, and loading of functions from system or user configuration directories (#7921, #1256). - When universal variables are unavailable for some reason, setting a universal variable now sets a global variable instead (#7921).
$last_pid
now contains the process ID of the last process in the pipeline, allowing it to be used in scripts (#5036, #5832, #7721). Previously, this value contained the process group ID, but in scripts this was the same as the running fish's process ID.process-exit
event handlers now receive the same value as$status
in all cases, instead of receiving -1 when the exit was due to a signal.process-exit
event handlers for PID 0 also receivedJOB_EXIT
events; this has been fixed.job-exit
event handlers may now be created with any of the PIDs from the job. The handler is passed the last PID in the job as its second argument, instead of the process group.- Trying to set an empty variable name with
set
no longer works (these variables could not be used in expansions anyway). fish_add_path
handles an undefinedPATH
environment variable correctly (#8082).
Interactive improvements
- Commands entered before the previous command finishes will now be properly syntax highlighted.
- fish now automatically creates
config.fish
and the configuration directories in$XDG_CONFIG_HOME/fish
(by default~/.config/fish
) if they do not already exist (#7402). $SHLVL
is no longer incremented in non-interactive shells. This means it won't be set to values larger than 1 just because your environment happens to run some scripts in $SHELL in its startup path (#7864).- fish no longer rings the bell when flashing the command line. The flashing should already be enough notification and the bell can be annoying (#7875).
fish --help
is more helpful if the documentation isn't installed (#7824).funced
won't include an entry on where a function is defined, thanks to the newfunctions --no-details
option (#7879).- A new variable,
fish_killring
, containing entries from the killring, is now available (#7445). fish --private
prints a note on private mode on startup even if$fish_greeting
is an empty list (#7974).- fish no longer attempts to lock history or universal variable files on remote filesystems, including NFS and Samba mounts. In rare cases, updates to these files may be dropped if separate fish instances modify them simultaneously. (#7968).
wait
andon-process-exit
work correctly with jobs that have already exited (#7210).__fish_print_help
(used for--help
output for fish's builtins) now respects theLESS
environment variable, and if not set, uses better default pager settings (#7997).- Errors from
alias
are now printed to standard error, matching other builtins and functions (#7925). ls
output is colorized on OpenBSD if colorls utility is installed (#8035)- The default pager color looks better in terminals with light backgrounds (#3412).
- Further robustness improvements to the bash history import (#7874).
- fish now tries to find a Unicode-aware locale for encoding (
LC_CTYPE
) if started without any locale information, improving the display of emoji and other non-ASCII text on misconfigured systems (#8031). To allow a C locale, set the variablefish_allow_singlebyte_locale
to 1. - The Web-based configuration and documentation now feature a dark mode if the browser requests it (#8043).
- Color variables can now also be given like
--background red
and-b red
, not just--background=red
(#8053). exit
run withinfish_prompt
now exits properly (#8033).- When attempting to execute the unsupported POSIX-style brace command group (
{ ... }
) fish will suggest its equivalentbegin; ...; end
commands (#6415).
New or improved bindings
- Pasting in Vi mode puts text in the right place in normal mode (#7847).
- Vi mode's
u
is bound toundo
instead ofhistory-search-backward
, following GNU readline's behavior. Similarly,Control-R
is bound toredo
instead ofhistory-search-backward
, following Vim (#7908). s
in Vi visual mode now does the same thing asc
(#8039).- The binding for
"\*y
now usesfish_clipboard_copy
, allowing it to support more than justxsel
. - The
Control-Space
binding can be correctly customised (#7922). exit
works correctly in bindings (#7967).- The
F1
binding, which opens the manual page for the current command, now works around a bug in certainless
versions that fail to clear the screen (#7863). - The binding for
Alt-S
...
fish 3.2.2 (released April 7, 2021)
This release of fish fixes a number of additional issues identified in the fish 3.2 series:
- The command-not-found handler used suggestions from
pacman
on Arch Linux, but this caused major slowdowns on some systems and has been disabled (#7841). - fish will no longer hang on exit if another process is in the foreground on macOS (#7901).
- Certain programs (such as
lazygit
) could create situations where fish would not receive keystrokes correctly, but it is now more robust in these situations (#7853). - Arguments longer than 1024 characters no longer trigger excessive CPU usage on macOS (#7837).
- fish builds correctly on macOS when using new versions of Xcode (#7838).
- Completions for
aura
(#7865) andtshark
(#7858) should no longer produce errors. - Background jobs no longer interfere with syntax highlighting (a regression introduced in fish 3.2.1, #7842).
If you are upgrading from version 3.1.2 or before, please also review the release notes for 3.2.1 and 3.2.0.
Download links: To download the source code for fish, use the file named "fish-3.2.2.tar.xz". The file downloaded from "Source code (tar.gz)" will not build correctly. The SHA-256 sum of this file is 5944da1a8893d11b0828a4fd9136ee174549daffb3d0adfdd8917856fe6b4009
. A GPG signature from David Adam (key ID 0x7A67D962D88A709A
) is available as "fish-3.2.2.tar.xz.asc".
fish 3.2.1 (released March 18, 2021)
This release of fish fixes the following problems identified in fish 3.2.0:
- Commands in key bindings are run with fish's internal terminal modes, instead of the terminal modes typically used for commands. This fixes a bug introduced in 3.2.0, where text would unexpectedly appear on the terminal, especially when pasting (#7770).
- Prompts which use the internal
__fish_print_pipestatus
function will display correctly rather than carrying certain modifiers (such as bold) further than intended (#7771). - Redirections to internal file descriptors is allowed again, reversing the changes in 3.2.0. This fixes a problem with Midnight Commander (#7769).
- Universal variables should be fully reliable regardless of operating system again (#7774).
fish_git_prompt
no longer causes screen flickering in certain terminals (#7775).fish_add_path
manipulates thefish_user_paths
variable correctly when moving multiple paths (#7776).- Pasting with a multi-line command no longer causes a
__fish_tokenizer_state
error (#7782). psub
inside event handlers cleans up temporary files properly (#7792).- Event handlers declared with
--on-job-exit $fish_pid
no longer run constantly (#7721), although these functions should use--on-event fish_exit
instead. - Changing terminal modes inside
config.fish
works (#7783). set_color --print-colors
no longer prints all colors in bold (#7805)- Completing commands starting with a
-
no longer prints an error (#7809). - Running
fish_command_not_found
directly no longer produces an error on macOS or other OSes which do not have a handler available (#7777). - The new
type
builtin now has the (deprecated)--quiet
long form of-q
(#7766).
It also includes some small enhancements:
help
andfish_config
work correctly when fish is running in a Chrome OS Crostini Linux VM (#7789).- The history file can be made a symbolic link without it being overwritten (#7754), matching a similar improvement for the universal variable file in 3.2.0.
- An unhelpful error ("access: No error"), seen on Cygwin, is no longer produced (#7785).
- Improvements to the
rsync
completions (#7763), some completion descriptions (#7788), and completions that use IP address (#7787). - Improvements to the appearance of
fish_config
(#7811).
If you are upgrading from version 3.1.2 or before, please also review the release notes for 3.2.0 (included below).
Download links: To download the source code for fish, use the file named "fish-3.2.1.tar.xz". The file downloaded from "Source code (tar.gz)" will not build correctly. The SHA-256 sum of this file is d8e49f4090d3778df17dd825e4a2a80192015682423cd9dd02b6675d65c3af5b
. A GPG signature from David Adam (key ID 0x7A67D962D88A709A
) is available as "fish-3.2.1.tar.xz.asc".
fish 3.2.0 (released March 1, 2021)
Notable improvements and fixes
- Undo and redo support for the command-line editor and pager search (#1367). By default, undo is bound to Control+Z, and redo to Alt+/.
- Builtins can now output before all data is read. For example,
string replace
no longer has to read all of stdin before it can begin to output. This makes it usable also for pipes where the previous command hasn't finished yet, like:
# Show all dmesg lines related to "usb"
dmesg -w | string match '*usb*'
- Prompts will now be truncated instead of replaced with
"> "
if they are wider than the terminal (#904). For example:
~/dev/build/fish-shell-git/src/fish-shell/build (makepkg)>
will turn into:
…h-shell/build (makepkg)>
It is still possible to react to the COLUMNS
variable inside the prompt to implement smarter behavior.
- fish completes ambiguous completions after pressing
Tab
even when they have a common prefix, without the user having to pressTab
again (#6924). - fish is less aggressive about resetting terminal modes, such as flow control, after every command. Although flow control remains off by default, enterprising users can now enable it with
stty
(#2315, #7704). - A new "fish_add_path" helper function to add paths to $PATH without producing duplicates, to be used interactively or in
config.fish
(#6960, #7028). For example:
fish_add_path /opt/mycoolthing/bin
will add /opt/mycoolthing/bin to the beginning of $fish_user_path without creating duplicates, so it can be called safely from config.fish or interactively, and the path will just be there, once.
- Better errors with "test" (#6030):
> test 1 = 2 and echo true or false
test: Expected a combining operator like '-a' at index 4
1 = 2 and echo true or echo false
^
This includes numbering the index from 1 instead of 0, like fish lists.
- A new theme for the documentation and Web-based configuration (#6500, #7371, #7523), matching the design on fishshell.com.
fish --no-execute
will no longer complain about unknown commands or non-matching wildcards, as these could be defined differently at runtime (especially for functions). This makes it usable as a static syntax checker (#977).string match --regex
now integrates named PCRE2 capture groups as fish variables, allowing variables to be set directly fromstring match
(#7459). To support this functionality,string
is now a reserved word and can no longer be wrapped in a function.- Globs and other expansions are limited to 512,288 results (#7226). Because operating systems limit the number of arguments to commands, larger values are unlikely to work anyway, and this helps to avoid hangs.
- A new "fish for bash users" documentation page gives a quick overview of the scripting differences between bash and fish (#2382), and the completion tutorial has also been moved out into its own document (#6709).
Syntax changes and new commands
- Range limits in index range expansions like
$x[$start..$end]
may be omitted:$start
and$end
default to 1 and -1 (the last item) respectively (#6574):
echo $var[1..]
echo $var[..-1]
echo $var[..]
All print the full list $var
.
- When globbing, a segment which is exactly
**
may now match zero directories. For example**/foo
may matchfoo
in the current directory (#7222).
Scripting improvements
- The
type
,_
(gettext),.
(source) and:
(no-op) functions
are now implemented builtins for performance purposes (#7342, #7036, #6854). set
and backgrounded jobs no longer overwrite$pipestatus
(#6820), improving its use in command substitutions (#6998).- Computed ("electric") variables such as
status
are now only global in scope, soset -Uq status
returns false (#7032). - The output for
set --show
has been shortened, only mentioning the scopes in which a variable exists (#6944). In addition, it now shows if a variable is a path variable. - A new variable,
fish_kill_signal
, is set to the signal that terminated the last foreground job, or0
if the job exited normally (#6824, #6822). - A new subcommand,
string pad
, allows extending strings to a given width (#7340, #7102). string sub
has a new--end
option to specify the end index of
a substring (#6765, #5974).string split
has a new--fields
option to specify fields to
output, similar tocut -f
(#6770).string trim
now also trims vertical tabs by default (#6795).string replace
no longer prints an error if a capturing group wasn't matched, instead treating it as empty (#7343).string
subcommands now quit early when used with--quiet
(#7495).string repeat
now handles multiple arguments, repeating each one (#5988).printf
no longer prints an error if not given an argument (not
even a format string).- The
true
andfalse
builtins ignore any arguments, like other shells (#7030). fish_indent
now removes unnecessary quotes in simple cases (#6722)
and gained a--check
option to just check if a file is indented correctly (#7251).fish_indent
indents continuation lines that follow a line ending in a backslash,|
,&&
or||
.pushd
only adds a directory to the stack if changing to it was successful (#6947).- A new
fish_job_summary
function is called whenever a background job stops or ends, or any job terminates from a signal (#6959, #2727, #4319).
The default behaviour can now be customized by redefining it. status
gained newdirname
andbasename
convenience subcommands to get just the directory to the running script or the name of it, to simplify common tasks such as running(dirname (status filename))
(#7076, #1818).- Broken pipelines are now handled more smoothly; in particular, bad redirection mid-pipeline results in the job continuing to run but with the broken file descriptor replaced with a closed file descriptor. This allows better error recovery and is more in line with other shells' behaviour (#7038).
jobs --quiet PID
no longer prints "no suitable job" if the job for PID does not exist (eg because it has finished) (#6809, #6812).jobs
now shows continued child processes correctly (#6818)disown
should no longer create zombie processes when job control is off, such as inconfig.fish
(#7183).command
,jobs
andtype
builtins support--query
as the long form of-q
, matching other builtins.
The long form--quiet
is deprecated (#7276).argparse
no longer requires a short flag letter for long-only options (#7585)
and only prints a backtrace with invalid options to argparse itself (#6703).argparse
now passes the validation variables (e.g.$_flag_value
) as local-exported variables,
avoiding the need for--no-scope-shadowing
in validation functions.complete
takes the first argument as the name of the command if the--command
/-c
option is not used,
socomplete git
is treated ...
fish 3.1.2 (released April 29, 2020)
Download links: To download the source code for fish, use the file named "fish-3.1.2.tar.gz
". The SHA-256 sum of this file is d5b927203b5ca95da16f514969e2a91a537b2f75bec9b21a584c4cd1c7aa74ed
. The file downloaded from "Source code (tar.gz)" will not build correctly. A GPG signature from David Adam (0x7A67D962D88A709A) is available as "fish-3.1.2.tar.gz.asc
".
This release of fish fixes a major issue discovered in fish 3.1.1:
- Commands such as
fzf
andenhancd
, when used witheval
, would hang.eval
buffered output too aggressively, which has been fixed (#6955).
If you are upgrading from version 3.0.0 or before, please also review the release notes for 3.1.1, 3.1.0 and 3.1b1.
fish 3.1.1 (released April 27, 2020)
Download links: To download the source code for fish, use the file named "fish-3.1.1.tar.gz
". The SHA-256 sum of this file is 07dc78eea3bc4cbd490b2f2a2e19e5771ac9e3b6b1a75893039ad8b34d6122b8
. The file downloaded from "Source code (tar.gz)" will not build correctly. A GPG signature from David Adam (0x7A67D962D88A709A) is available as "fish-3.1.1.tar.gz.asc
".
This release of fish fixes a number of major issues discovered in fish 3.1.0.
- Commands which involve
. ( ... | psub)
now work correctly, as a bug in thefunction --on-job-exit
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). - 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). - Redirections that append to a file descriptor (eg
2>>&1
) 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 ofbuiltin -n
, andtime --help
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
returnsstatus
instead ofF=B
(#6635).test
no longer crashes when used with "nan
" or "inf
" 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).- Functions using
--on-job-exit
and--on-process-exit
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. - Functions using
--on-variable
work reliably with variables which are set implicitly (rather than withset
), such as "fish_bind_mode
" and "PWD
" (#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). - 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
. - The VCS prompt,
fish_vcs_prompt
, no longer displays Subversion (svn
) 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
orPOSIX
locale) no longer renders all output blank (#6736). help
prefers to usexdg-open
, avoiding the use ofopen
on Debian systems where this command is actuallyopenvt
(#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 oreval
will no longer have separate process groups. (#6624, #6806).
This release also includes:
- 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.
If you are upgrading from version 3.0.0 or before, please also review the release notes for 3.1.0 and 3.1b1.
Errata for fish 3.1
A new builtin, time
, was introduced in the fish 3.1 releases. This builtin is a reserved word (like test
, function
, and others) because of the way it is implemented, and functions can no longer be named time
. This was not clear in the fish 3.1b1 release notes.
fish 3.1.0 (released February 12, 2020)
Download links: To download the source code for fish, use the file named "fish-3.1.0.tar.gz
". The SHA-256 sum of this file is e5db1e6839685c56f172e1000c138e290add4aa521f187df4cd79d4eab294368
. The file downloaded from "Source code (tar.gz)" will not build correctly. A GPG signature from David Adam (0x7A67D962D88A709A) is available as "fish-3.1.0.tar.gz.asc
".
Compared to the beta release of fish 3.1b1, fish version 3.1.0:
- 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; and
- contains some improvements to the documentation and a small number of completions.
If you are upgrading from version 3.0.0 or before, please also review the release notes for 3.1b1 (included below).
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). - 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). - 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 viafish --print-debug-categories
(#5879). A new--debug-output
option allows for redirection of debug output. string
has a newcollect
subcommand for use in command substitutions, producing a single output instead of splitting on new lines (similar to"$(cmd)"
in other shells) (#159).- The fish manual, tutorial and FAQ are now available in
man
format asfish-doc
,fish-tutorial
andfish-faq
respectively (#5521). - Like other shells,
cd
now always looks for its argument in the current directory as a last resort, even if theCDPATH
variable does not include it or "." (#4484). - fish now correctly handles
CDPATH
entries that start with..
(#6220) or contain./
(#5887). - The
fish_trace
variable may be set to trace execution (#3427). This performs a similar role asset -x
in other shells. - fish uses the temporary directory determined by the system, rather than relying on
/tmp
(#3845). - The fish Web configuration tool (
fish_config
) 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). - 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). - New redirections
&>
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).- The
VAR=val cmd
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 likeand and and
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 thatmath '3^0.5^2'
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).- In the interest of consistency,
builtin -q
andcommand -q
can now be used to query if a builtin or command exists (#5631). math
now accepts--scale=max
for the maximum scale (#5579).builtin $var
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).complete --do-complete
now also does fuzzy matches (#5467).complete --do-complete
can be used inside completions, allowing limited recursion (#3474).count
now also counts lines fed on standard input (#5744).eval
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).complete -C foo
now works as expected, rather than requiringcomplete -Cfoo
.complete
has a new--force-files
option, to re-enable file completions. This allowssudo -E
andpacman -Qo
to complete correctly (#5646).argparse
now defaults to showing the current function name (instead ofargparse
) in its errors, making--name
often superfluous (#5835).argparse
has a new--ignore-unknown
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).read -S
(short option of--shell
) 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).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).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.fish_indent
now handles semicolons better, including leaving them in place for; and
and; or
instead of breaking the line (#5859).fish_indent --write
now supports multiple file arguments, indenting them in turn.- The default read limit has been increased to 100MiB (#5267).
math
now also understandsx
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).functions --erase
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).commandline -p
andcommandline -j
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). 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.abbr
has a new--query
option to check for the existence of an abbreviation.- Local values for
fish_complete_path
andfish_function_path
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). - 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). - 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). type
supports a new option,--short
, 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.type --force-path
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). - 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). - The locale is now reloaded when the
LOCPATH
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).dirh
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).- Builtin...
fish 3.1b1 (released January 26, 2020)
Download links: To download the source code for fish, we suggest the file named "fish-3.1b1.tar.gz". The file downloaded from "Source code (tar.gz)" will not build correctly. The SHA-256 sum of this file is 7847cb2777cc6ea2a18f147a0e567de5bdac4febf6afdfcf867eb45501183a1a
. A GPG signature from David Adam (0x7A67D962D88A709A) is available as "fish-3.1b1.tar.gz.asc".
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). - 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). - 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 viafish --print-debug-categories
(#5879). A new--debug-output
option allows for redirection of debug output. string
has a newcollect
subcommand for use in command substitutions, producing a single output instead of splitting on new lines (similar to"$(cmd)"
in other shells) (#159).- The fish manual, tutorial and FAQ are now available in
man
format asfish-doc
,fish-tutorial
andfish-faq
respectively (#5521). - Like other shells,
cd
now always looks for its argument in the current directory as a last resort, even if theCDPATH
variable does not include it or "." (#4484). - fish now correctly handles
CDPATH
entries that start with..
(#6220) or contain./
(#5887). - The
fish_trace
variable may be set to trace execution (#3427). This performs a similar role asset -x
in other shells. - fish uses the temporary directory determined by the system, rather than relying on
/tmp
(#3845). - The fish Web configuration tool (
fish_config
) 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). - 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). - New redirections
&>
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).- The
VAR=val cmd
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 likeand and and
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 thatmath '3^0.5^2'
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).- In the interest of consistency,
builtin -q
andcommand -q
can now be used to query if a builtin or command exists (#5631). math
now accepts--scale=max
for the maximum scale (#5579).builtin $var
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).complete --do-complete
now also does fuzzy matches (#5467).complete --do-complete
can be used inside completions, allowing limited recursion (#3474).count
now also counts lines fed on standard input (#5744).eval
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).complete -C foo
now works as expected, rather than requiringcomplete -Cfoo
.complete
has a new--force-files
option, to re-enable file completions. This allowssudo -E
andpacman -Qo
to complete correctly (#5646).argparse
now defaults to showing the current function name (instead ofargparse
) in its errors, making--name
often superfluous (#5835).argparse
has a new--ignore-unknown
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).read -S
(short option of--shell
) 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).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).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.fish_indent
now handles semicolons better, including leaving them in place for; and
and; or
instead of breaking the line (#5859).fish_indent --write
now supports multiple file arguments, indenting them in turn.- The default read limit has been increased to 100MiB (#5267).
math
now also understandsx
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).functions --erase
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).commandline -p
andcommandline -j
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). 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.abbr
has a new--query
option to check for the existence of an abbreviation.- Local values for
fish_complete_path
andfish_function_path
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). - 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). - 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). type
supports a new option,--short
, 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.type --force-path
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). - 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). - The locale is now reloaded when the
LOCPATH
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).dirh
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).- 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.- 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).- A bug where
disown
could crash the shell ...