Fish Shell Release Notes

This release fixes the following problems identified in fish 4.9.0:

• On non-default keyboard layouts, fish executed bindings for physical keys instead of only bindings for the layout’s key. For example, on the Dvorak layout, typing s would insert ; because there is a default binding for ; (#12968).
• When typing space to accept a character entered via certain IMEs, fish would insert a space instead of the desired character, which has been fixed (#12974).
• On macOS terminals, keys like option-l would execute bindings for alt-l instead of the historical behavior of inserting a character (like @ on a German layout) (#12973).

Interactive improvements

• To mitigate issues in Konsole version v26.07.80’s implementation of the kitty keyboard protocol, fish no longer requests that protocol on Konsole. The omit-term-workarounds feature flag can be turned on to enable the kitty keyboard protocol on Konsole again (#12948).
• On some terminals like kitty, keys like shift-space and space can now be mapped independently (#12898).
• Fixed slow tab completion in directories that contain slow-to-resolve symlinks (e.g. links to network-mounted files) (#12905).
• Abbreviations can now be given a description, which will be displayed in the completion pager (#11291).
• Vi mode commands like cF and cT now work correctly (#12947).

Scripting improvements

• List indexing can now be nested in more cases; for example $foo[$bar[1]2] is now allowed (#12903).
• Escaped square brackets (e.g. \133 for [) are no longer considered a slicing operator (#7969).
• Variables containing a closing square brackets and used to index into another variable will no longer close the slice early (#12819).
• Builtin help pages now respect an override of the man function (#12886).
• Commands like status=123 echo $status now throw an error instead of silently ignore the variable override (#7790).

Regression fixes

• (From 4.6.0) Chinese and Japanese translation of error messages owned by the C library were broken (#12895).
• (From 4.3.2) Erasing read-only variables with set --erase was accidentally allowed.
• (From 4.0.0) Builtin fg was not working on NetBSD (#12929).

Interactive improvements

• On non-macOS platforms, alt-backspace, alt-delete, alt-left and alt-right operate on words again instead of tokens (#12122) eliminating cross-platform differences in input handling.
• Builtin and function commands can now be colored separately via new variables $fish_color_builtin and $fish_color_function (#12837).
• Add fish_darcs_prompt for Darcs repository status.
• Fixed a crash in commandline --current-process when the cursor is inside a &| pipe (#12868).
• Since prompt marking (via OSC 133) causes an issue in Konsole’s default configuration, prompt marking had been disabled for Konsole in 4.8.0. Now the omit-term-workarounds feature flag can be enabled to enable prompt marking on Konsole again (#12859).

Regression fixes

• (From 4.8.0) abbr --position=anywhere completions are no longer offered in argument position, to avoid cluttering the completion pager (#12838).
• (From 4.8.0) pacman -Q short option completions (#12857).

Notable improvements and fixes

• Translatable messages defined in Rust source code can and should now be translated using Fluent instead of GNU gettext. To make Fluent easy to work with, we have added tooling based on the new fluent-ftl-tools library. See Contributing Translations (#11928).

Deprecations and removed features

• Builtin complete’s --command and --path options no longer unescape their argument.

Interactive improvements

• History search would sometimes forget about commands after those were re-run in concurrent sessions. This has been fixed (#10300).
• fish_hg_prompt, fish_git_prompt, and fish_fossil_prompt now strip control characters from VCS state read off disk, matching prompt_pwd.
• Abbreviations with --position=anywhere can now be completed in argument position, not just in command position (#12630).
• Path component movement (ctrl-w) skips escaped characters.
• Completion of short option groups will now handle --condition correctly (#12821).
• Fixed an issue where ctrl-c might fail to cancel certain functions (#12802).
• On the first run after upgrading from an older version, fish will try harder to check if the current theme matches a historical default. If it does match, fish won’t create ~/.config/fish/conf.d/fish_frozen_theme.fish when upgrading from fish < 4.3. In particular, on systems where fish version 3.x was installed originally, fish will now avoid creating that file on upgrade (#12725).

Scripting improvements

• cd supports the -L and -P options, like other shells, to allow specifying whether symbolic links (symlinks) are resolved when changing directories (#7206).
• cd with a relative path will now retry using the real current directory, if $PWD has been moved (#12700).
• Nested brace expansions now strip unquoted leading and trailing spaces from entries consistently (#12794).
• bind shows the files where bindings were defined (#12504).

Other improvements

• fish no longer creates the __fish_initialized universal variable on startup. If you don’t expect to need to downgrade to earlier versions, you can remove it with set --erase __fish_initialized. This means that fish now only creates universal variables if instructed by the user.

For distributors and developers

• With the exception of the $CMAKE_INSTALL_PREFIX/share/fish/man directory, fish no longer installs files to $CMAKE_INSTALL_PREFIX/share/fish. In particular, this means that both $CMAKE_INSTALL_PREFIX/share/fish/completions and $CMAKE_INSTALL_PREFIX/share/fish/functions should no longer exist. These directories have been ignored since fish 4.2. If another package installs fish scripts there, they should be corrected to install to extra_completionsdir (typically $CMAKE_INSTALL_PREFIX/share/fish/vendor_completions.d), extra_functionsdir (typically $CMAKE_INSTALL_PREFIX/share/fish/vendor_functions.d) or extra_confdir (typically $CMAKE_INSTALL_PREFIX/share/fish/vendor_functions.d) instead. See also the output of for var in completions functions conf; pkgconf fish --variable="$var"dir; end.

Regression fixes:

• (from 4.4.0) Vi mode c,W key binding wrongly deleted trailing spaces (#12790).
• (from 4.4.0) Vi mode c,x in builtin read (#12724).
• (from 4.3.3) Repeated tab would sometimes insert smartcase completions redundantly.
• (from 4.3.0) Pressing escape during command execution could insert garbage text into the command line (#12379).

Deprecations and removed features

The default theme (i.e. the fish_color_* variables) is no longer set in non-interactive shells.

Interactive improvements

prompt_pwd now strips control characters.

Repaint events no longer reset the completion pager and other transient UI states (#12683).

fish_color_valid_path now respects background and underline colors (#12622).

funced will no longer lose work if there are parse errors multiple times without new changes to the file.

Fixed a case where directory completions were sorted in a surprising order (#12695).

When at the command token, the alt-o binding will now open read-only files too (#12671).

Private mode in-memory history (set fish_history) is no longer shared with builtin read (#12662).

Other improvements

History is no longer corrupted with NUL bytes when fish receives SIGTERM or SIGHUP (#10300).

fish_update_completions now handles groff \X'...' device control escapes, fixing completion generation for man pages produced by help2man 1.50 and later (such as coreutils 9.10).

Removing history entries via the web-based config is more intuitive.

If XDG_DATA_DIRS is empty, the default value is assumed, which means that fish will now also use configuration from paths like $PREFIX/share/fish/vendor_completions.d (#11349).

Some internal file descriptors were moved to number 10 or higher, to reduce risk of clashes with those used by the user in scripts.

The wording of error messages has been made consistent, especially for builtin subcommands (#12556).

For distributors and developers

When the default global config directory ($PREFIX/etc/fish) exists but has been overridden via -DCMAKE_INSTALL_SYSCONFDIR, fish will now respect that override (#10748).

build_tools/update_translations.fish has been replaced by cargo xtask gettext {check,new,update} (#12676).

cargo xtask shellcheck to lint shell-scripts.

Regression fixes

• (from 4.6) Vi mode dl (#12461).

• (from 4.6) Backspace after newline (#12583).

• (from 4.3.3) Long options were spuriously completed after typing short options (85e76ba3561).

• (from 3.2) nosuchcommand || echo hello executes the right hand side again (#12654).

Deprecations and removed features

• The default theme (i.e. the fish_color_* variables) is no longer set in non-interactive shells.

Interactive improvements

• prompt_pwd now strips control characters.
• Repaint events (as triggered by changes to color variables or by event handlers running commandline -f repaint) no longer reset the completion pager and other transient UI states (#12683).
• fish_color_valid_path now respects background and underline colors (#12622).
• funced will no longer lose work if there are parse errors multiple times without new changes to the file.
• Fixed a case where directory completions were sorted in a surprising order (#12695).
• When at the command token, the alt-o binding will now open read-only files too (#12671).
• Private mode in-memory history (set fish_history) is no longer shared with builtin read (#12662).

Other improvements

• History is no longer corrupted with NUL bytes when fish receives SIGTERM or SIGHUP (#10300).
• fish_update_completions now handles groff \X'...' device control escapes, fixing completion generation for man pages produced by help2man 1.50 and later (such as coreutils 9.10).
• Removing history entries via the web-based config is more intuitive.
• If XDG_DATA_DIRS is empty, the default value is assumed, which means that fish will now also use configuration from paths like $PREFIX/share/fish/vendor_completions.d (#11349).
• Some internal file descriptors were moved to number 10 or higher, to reduce risk of clashes with those used by the user in scripts.
• The wording of error messages has been made consistent, especially for builtin subcommands (#12556).

For distributors and developers

• When the default global config directory ($PREFIX/etc/fish) exists but has been overridden via -DCMAKE_INSTALL_SYSCONFDIR, fish will now respect that override (#10748).
• build_tools/update_translations.fish has been replaced by cargo xtask gettext {check,new,update} (#12676).
• cargo xtask shellcheck to lint shell-scripts.

Regression fixes

• (from 4.6) Vi mode dl (#12461).
• (from 4.6) Backspace after newline (#12583).
• (from 4.3.3) Long options were spuriously completed after typing short options (85e76ba3561).
• (from 3.2) nosuchcommand || echo hello executes the right hand side again (#12654).

Notable improvements and fixes

• New Spanish translations (#12489).
• New Japanese translations (#12499).

Deprecations and removed features

• The default width for emoji is switched from 1 to 2, improving the experience for users connecting to old systems from modern desktops. Users of old desktops who notice that lines containing emoji are misaligned can set $fish_emoji_width back to 1 (#12562).

Interactive improvements

• The tab completion pager now left-justifies the description of each column (#12546).
• fish now supports the SHELL_PROMPT_PREFIX, SHELL_PROMPT_SUFFIX, and SHELL_WELCOME environment variables. The prefix and suffix are automatically prepended and appended to the left prompt, and the welcome message is displayed on startup after the greeting. These variables are set by systemd's run0 for example (#10924).

Improved terminal support

• set_color is able to turn off italics, reverse mode, strikethrough and underline individually (e.g. --italics=off).
• set_color learned the foreground (--foreground or -f) and reset (--reset) options.
• An error caused by slow terminal responses at macOS startup has been addressed (#12571).

Other improvements

• Signals like SIGWINCH (as sent on terminal resize) no longer interrupt builtin output (#12496).
• For compatibility with Bash, fish now accepts |& as alternate spelling of &|, for piping both standard output and standard error (#11516).
• fish_indent now preserves comments and newlines immediately preceding a brace block ({
  }) (#12505).
• A crash when suspending certain pipelines with ctrl-z has been fixed (#12301).

For distributors and developers

• cargo xtask subcommands no longer panic on test failures.

Regression fixes:

• (from 4.5.0) Intermediate artifact when redrawing prompt (#12476).
• (from 4.4.0) history honors explicitly specified --color= again (#12512).
• (from 4.4.0) Vi mode dl and dh (#12461).
• (from 4.3.0) Error completing of commands starting with - (#12522).

Notable improvements and fixes

• New Spanish translations (#12489).
• New Japanese translations (#12499).

Deprecations and removed features

• The default width for emoji is switched from 1 to 2, improving the experience for users connecting to old systems from modern desktops. Users of old desktops who notice that lines containing emoji are misaligned can set $fish_emoji_width back to 1 (#12562).

Interactive improvements

• The tab completion pager now left-justifies the description of each column (#12546).
• fish now supports the SHELL_PROMPT_PREFIX, SHELL_PROMPT_SUFFIX, and SHELL_WELCOME environment variables. The prefix and suffix are automatically prepended and appended to the left prompt, and the welcome message is displayed on startup after the greeting. These variables are set by systemd’s run0 for example (#10924).

Improved terminal support

• set_color is able to turn off italics, reverse mode, strikethrough and underline individually (e.g. --italics=off).
• set_color learned the foreground (--foreground or -f) and reset (--reset) options.
• An error caused by slow terminal responses at macOS startup has been addressed (#12571).

Other improvements

• Signals like SIGWINCH (as sent on terminal resize) no longer interrupt builtin output (#12496).
• For compatibility with Bash, fish now accepts |& as alternate spelling of &|, for piping both standard output and standard error (#11516).
• fish_indent now preserves comments and newlines immediately preceding a brace block ({ ... }) (#12505).
• A crash when suspending certain pipelines with ctrl-z has been fixed (#12301).

For distributors and developers

• cargo xtask subcommands no longer panic on test failures.

Regression fixes

• (from 4.5.0) Intermediate ⏎ artifact when redrawing prompt (#12476).
• (from 4.4.0) history honors explicitly specified --color= again (#12512).
• (from 4.4.0) Vi mode dl and dh (#12461).
• (from 4.3.0) Error completing of commands starting with - (#12522).

Interactive improvements

• ctrl-l no longer cancels history search (#12436).
• History search cursor positioning now works correctly with characters of arbitrary width.

Deprecations and removed features

• fish no longer reads the terminfo database to alter behaviour based on the TERM environment variable, and does not depend on ncurses or terminfo. The ignore-terminfo feature flag, introduced and enabled by default in fish 4.1, is now permanently enabled. fish may no longer work correctly on Data General Dasher D220 and Wyse WY-350 terminals, but should continue to work on all known terminal emulators released in the 21st century.

Regression fixes:

• (from 4.4.0) Vi mode d,f key binding did not work (#12417).
• (from 4.4.0) Vi mode c,w key binding wrongly deleted trailing spaces (#12443).
• (from 4.4.0) Vi mode crash on c,i,w after accepting autosuggestion (#12430).
• (from 4.4.0) fish_vi_key_bindings called with a mode argument produced an error (#12413).
• (from 4.0.0) Build on Illumos (#12410).

Deprecations and removed features

The default fossil prompt has been disabled (#12342).

Interactive improvements

The bind builtin lists mappings from all modes if --mode is not provided (#12214).

Line-wise autosuggestions that don’t start a command are no longer shown (739b82c34db, 58e7a50de8a).

Builtin history now assumes that PAGER supports ANSI color sequences.

fish now clears the terminal’s FLUSHO flag when acquiring control of the terminal, to fix an issue caused by pressing ctrl-o on macOS (#12304).

New or improved bindings

Vi mode word movements (w, W, e, and E) are now largely in line with Vim. The only exception is that underscores are treated as word separators (#12269).

New special input functions to support these movements: forward-word-vi, kill-word-vi, forward-bigword-vi, kill-bigword-vi, forward-word-end, backward-word-end, forward-bigword-end, backward-bigword-end, kill-a-word, kill-inner-word, kill-a-bigword, and kill-inner-bigword.

Vi mode key bindings now support counts for movement and deletion commands (e.g. d3w or 3l), via a new operator mode (#2192).

New catppuccin-* color themes.

Improved terminal support

set_color learned the strikethrough (--strikethrough or -s) modifier.

For distributors and developers

The CMake option WITH_GETTEXT has been renamed to WITH_MESSAGE_LOCALIZATION, to reflect that it toggles localization independently of the backend used in the implementation.

New cargo xtask commands can replace some CMake workflows.

Regression fixes

• (from 4.1.0) Crash when autosuggesting Unicode characters with nontrivial lowercase mapping (#12326, 78f4541116e).
• (from 4.3.0) Glitch on read --prompt-str "" (#12296).

Deprecations and removed features

• The default fossil prompt has been disabled (#12342).

Interactive improvements

• The bind builtin lists mappings from all modes if --mode is not provided (#12214).
• Line-wise autosuggestions that don’t start a command are no longer shown (739b82c34db, 58e7a50de8a).
• Builtin history now assumes that PAGER supports ANSI color sequences.
• fish now clears the terminal’s FLUSHO flag when acquiring control of the terminal, to fix an issue caused by pressing ctrl-o on macOS (#12304).

New or improved bindings

• Vi mode word movements (w, W, e, and E) are now largely in line with Vim. The only exception is that underscores are treated as word separators (#12269).
• New special input functions to support these movements: forward-word-vi, kill-word-vi, forward-bigword-vi, kill-bigword-vi, forward-word-end, backward-word-end, forward-bigword-end, backward-bigword-end, kill-a-word, kill-inner-word, kill-a-bigword, and kill-inner-bigword.
• Vi mode key bindings now support counts for movement and deletion commands (e.g. d3w or 3l), via a new operator mode (#2192).
• New catpuccin-* color themes.

Improved terminal support

• set_color learned the strikethrough (--strikethrough or -s) modifier.

For distributors and developers

• The CMake option WITH_GETTEXT has been renamed to WITH_MESSAGE_LOCALIZATION, to reflect that it toggles localization independently of the backend used in the implementation.
• New cargo xtask commands can replace some CMake workflows.

Regression fixes:

• (from 4.1.0) Crash when autosuggesting Unicode characters with nontrivial lowercase mapping (#12326, 78f4541116e).
• (from 4.3.0) Glitch on read --prompt-str "" (#12296).

Release notes

This release fixes the following problems identified in fish 4.3.0:

• Selecting a completion could insert only part of the token (#12249).
• Glitch with soft-wrapped autosuggestions and fish_right_prompt (#12255).
• Spurious echo in tmux when typing a command really fast (#12261).
• tomorrow theme always using the light variant (#12266).
• fish_config theme choose sometimes not shadowing themes set by e.g. webconfig (#12278).
• The sample prompts and themes are correctly installed (#12241).
• Last line of command output could be hidden when missing newline (#12246).

Other improvements include:

• The abbr, bind, complete, functions, history and type commands now support a --color option to control syntax highlighting in their output. Valid values are auto (default), always, or never.
• Existing file paths in redirection targets such as > file.txt are now highlighted using $fish_color_valid_path, indicating that file.txt will be clobbered (#12260).

Release fixes identified in 4.3.0

• Pre-built macOS packages failed to start due to a Malformed Mach-O file error (#12224).
• extra_functionsdir (usually vendor_functions.d) and friends were not used (#12226).
• Sample config file ~/.config/fish/config.fish/ and config directories ~/.config/fish/conf.d/, ~/.config/fish/completions/, and ~/.config/fish/functions/ were recreated on every startup instead of only the first time fish runs on a system (#12230).
• Spurious echo of ^[[I in some scenarios (#12232).
• Infinite prompt redraw loop on some prompts (#12233).
• The removal of pre-built HTML docs from tarballs revealed that cross compilation is broken because we use ${CMAKE_BINARY_DIR}/fish_indent for building HTML docs. As a workaround, the new CMake build option FISH_INDENT_FOR_BUILDING_DOCS can be set to the path of a runnable fish_indent binary.