| FISH_GREETING(1) | fish-shell | FISH_GREETING(1) |
NAME
fish_greeting - display a welcome message in interactive shells
SYNOPSIS
fish_greeting
function fish_greeting
... end
DESCRIPTION
When an interactive fish starts, it executes fish_greeting and displays its output.
The default fish_greeting is a function that prints a variable of the same name ($fish_greeting), so you can also just change that if you just want to change the text.
If SHELL_WELCOME <#envvar-SHELL_WELCOME> is set, it is displayed after the greeting. This is a standard environment variable that may be set by tools like systemd's run0 to display session information.
While you could also just put echo calls into config.fish, fish_greeting takes care of only being used in interactive shells, so it won't be used e.g. with scp (which executes a shell), which prevents some errors.
EXAMPLE
To just empty the text, with the default greeting function:
set -U fish_greeting
or set -g fish_greeting in config.fish <#configuration>.
A simple greeting:
function fish_greeting
echo Hello friend!
echo The time is (set_color yellow)(date +%T)(set_color --reset) and this machine is called $hostname end
Copyright
fish-shell developers
| October 26, 2026 | 4.9 |