Fish shell cheatsheet

Shortcut	Description
^A ←/^E →	Move to the line beginning/end
Alt ←/Alt →	Jump to the previous/next word
↑/↓	Switch to the previous/next command
Alt ↑/Alt ↓	Switch to the previous/next arguments
^U	Delete to the beginning
^C	Cancel the line
Alt H	Show the command man page description
Alt W	Show the short command description
Alt .	Repeat last argument

#!/usr/bin/env fish

echo 'Hello from Fish!'

# my comment

echo 'Hello from Fish!'
# or
printf '%s\n' 'Hello from Fish!'

Print the string with a trailing \n.

read my_variable

Reads the string to a variable my_variable.

for i in (seq 1 10)
  ...
end

# Declare the global/local variable:
set my_variable 'Hello from Fish!'

i# Remove the variable:
set --erase my_variable

echo $my_variable[1..10]
echo $my_variable[2..]
echo $my_variable[..-2]

set my_variable (math $my_variable + 1)
set my_variable (math $my_variable - 1)

echo (math 1 + 2)

Operator	Performs
+	Addition
-	Subtraction
*	Multiplication
/	Division
%	Modulo
^	Exponentiation

Match the string against a regular expression:

string match --regex --entire 'Fish' 'Hello from Fish!'

Pattern	Matches
x?	Zero or one x chars
x*	Any count x chars
x+	One or more x chars
x{n}	n times x chars
x{n,m}	n to m times x chars
x{n,}	n or more times x chars
[xy]	x or y char
[^xy]	not x or y char
\w	Word character
\d	Digit character
\W	Not word character
\D	Not digit character

Perl compatible regular expressions are described here.

# Replaces the first match
string replace --regex 'Fish' 'fish' 'Hello from Fish!'

# Replaces all matches
string replace --regex --all 'Fish' 'fish' 'Hello from Fish!'

if test $my_variable -lt $another_variable
  ···
else if test $my_variable -eq $another_variable
  ···
else
  ···
end

Numbers

Number operator	Meaning
-lt	[L]ess [t]han
-eq	[Eq]ual
-gt	[G]reater [t]han
-le	[L]ess than or [e]qual to
-ge	[G]reater than or [e]qual to
-ne	[N]ot [E]qual

Strings

String operator	Meaning
=	[Eq]ual
!=	[N]ot [E]qual

Files

File operator	Meaning
-f	[F]ile exists
-d	[D]irectory exists
-r	File or directory exists and [r]eadable
-w	File or directory exists and [w]ritable
-x	File or directory exists and e[x]ecutable

# Overwrite file
echo 'Hello from Fish!' > my_file

# Append to file
echo 'Hello from Fish!' >> my_file

my_command | another_command

Passes the first command stdout output as an input to a second command.

echo (math $my_variable + 1)

The (...) expression is substituted with the output of the command inside it.

echo (math $my_variable + 1 | psub)

The (... | psub) expression is substituted with a temporary file with the command’s output.

# Declare the function
function my_function --description 'My description'
  ···
end

# Remove the function
functions --erase my_function

emit my_event

Emits an event that can be picked up by other functions.

function my_hook --on-event my_event
  ···
end

Reacts to the my_event event.

# Declare the abbreviation
abbr --add grh "git reset --hard HEAD"

# Remove the abbreviation
abbr --erase grh

complete --command mycommand --arguments 'install uninstall'
complete --command mycommand --short-option 'h' --long-option 'help' --description 'Display help'

Option	Description
--arguments	Arguments to the command itself or option
--short-option	Short option
--long-option	Long option
--no-files	Don’t suggest files
--force-files	Suggest files
--condition	Display the hint only when a given condition is true
--description	Description

Declares the completion for a command.

complete --command mycommand --erase