1FISH(1) fish-shell FISH(1)
2
3
4
6 fish - the friendly interactive shell
7
9 fish [OPTIONS] [-c command] [FILE [ARGUMENTS...]]
10
12 fish is a command-line shell written mainly with interactive use in
13 mind. This page briefly describes the options for invoking fish. The
14 full manual is available in HTML by using the help command from inside
15 fish, and in the fish-doc(1) man page. The tutorial is available as
16 HTML via help tutorial or in fish-tutorial(1).
17
18 The following options are available:
19
20 · -c or --command=COMMANDS evaluate the specified commands instead of
21 reading from the commandline
22
23 · -C or --init-command=COMMANDS evaluate the specified commands after
24 reading the configuration, before running the command specified by -c
25 or reading interactive input
26
27 · -d or --debug=CATEGORY_GLOB enables debug output and specifies a glob
28 for matching debug categories (like fish -d). Defaults to empty.
29
30 · -o or --debug-output=path Specify a file path to receive the debug
31 output, including categories and fish_trace. The default is stderr.
32
33 · -i or --interactive specify that fish is to run in interactive mode
34
35 · -l or --login specify that fish is to run as a login shell
36
37 · -n or --no-execute do not execute any commands, only perform syntax
38 checking
39
40 · -p or --profile=PROFILE_FILE when fish exits, output timing informa‐
41 tion on all executed commands to the specified file
42
43 · -P or --private enables private mode, so fish will not access old or
44 store new history.
45
46 · --print-rusage-self when fish exits, output stats from getrusage
47
48 · --print-debug-categories outputs the list of debug categories, and
49 then exits.
50
51 · -v or --version display version and exit
52
53 · -D or --debug-stack-frames=DEBUG_LEVEL specify how many stack frames
54 to display when debug messages are written. The default is zero. A
55 value of 3 or 4 is usually sufficient to gain insight into how a
56 given debug call was reached but you can specify a value up to 128.
57
58 · -f or --features=FEATURES enables one or more feature flags (sepa‐
59 rated by a comma). These are how fish stages changes that might break
60 scripts.
61
62 The fish exit status is generally the exit status of the last fore‐
63 ground command. If fish is exiting because of a parse error, the exit
64 status is 127.
65
67 2019, fish-shell developers
68
69
70
71
723.1 Apr 29, 2020 FISH(1)