FISH(1)                           fish-shell                           FISH(1)

<?><?><?> (NAME)
       fish - <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       fish [<?><?><?><?><?><?><?><?>] [<?><?><?><?><?><?> [<?><?><?><?><?><?><?> ...]]
       fish [<?><?><?><?><?><?><?><?>] [-c <?><?><?><?><?> [<?><?><?><?><?><?><?> ...]]


<?><?><?><?><?><?><?> (DESCRIPTION)
       fish <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?>
       <?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> fish <?><?> <?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       help <?><?><?><?> fish <?><?><?><?><?><?><?> HTML <?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       fish-doc(1) <?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> HTML <?><?>
       <?><?><?><?> help tutorial <?><?> <?><?> man fish-tutorial <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?>:

       -c <?><?> --command=COMMAND
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> $argv
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -C <?><?> --init-command=COMMANDS
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?> -c <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?>.

       -d <?><?> --debug=DEBUG_CATEGORIES
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              (<?><?><?><?><?>) <?><?> <?><?><?><?> <?><?><?><?> <?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>.

       -o <?><?> --debug-output=DEBUG_FILE
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?> fish_trace<?>
              <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              (stderr) <?><?><?>.

       -i <?><?> --interactive
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?>.

       -l <?><?> --login
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              (login shell) <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

       -N <?><?> --no-config
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?>.

       -n <?><?> --no-execute
              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> (syntax checking) <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

       -p <?><?> --profile=PROFILE_FILE
              <?><?><?><?><?> <?><?><?><?> fish<?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>.

       --profile-startup=PROFILE_FILE
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> fish <?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

       -P <?><?> --private
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?>: fish <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       --print-rusage-self
              <?><?><?><?><?> <?><?><?><?> fish<?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> getrusage
              <?><?><?> <?><?><?><?><?><?>.

       --print-debug-categories
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -v <?><?> --version
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?> <?><?><?><?> <?><?><?><?><?><?>.

       -f <?><?> --features=FEATURES
              <?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              (feature flag) <?><?> <?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?> (exit status) <?><?><?><?><?> fish
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> (DEBUGGING)
       <?><?><?><?><?> fish <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       fish <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?>.  <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> --debug <?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> debug<?> error<?> warning <?>
       warning-path<?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?>/<?><?><?><?><?> <?><?><?><?><?><?><?><?> (background IO
       thread) <?><?> <?><?><?><?> <?><?><?><?><?><?>:

          > fish --debug=iothread

       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> fish --print-debug-categories <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?> --debug <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?> <?><?><?><?> (glob)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> complete<?> history<?>
       history-file <?> profile-history <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>:

          > fish --debug='complete,*history*'

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> stderr <?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> fish_trace <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> stderr <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       --debug-output <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>:

          > fish --debug='complete,*history*' --debug-output=/tmp/fish.log --init-command='set fish_trace on'

       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> FISH_DEBUG <?> FISH_DEBUG_OUTPUT
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> --debug <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> $FISH_DEBUG <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> - <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?> (<?><?><?><?> <?><?><?><?><?><?> reader-*,-ast*
       <?><?><?><?><?><?><?><?><?><?><?> reader <?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> ast <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>).

       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> --debug-output
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       FISH_DEBUG_OUTPUT <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> fish:

          fish

       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> fish:

          fish /path/to/script.fish

       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> fish:

          fish -c 'echo Hi there!'

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>:

          > fish -c 'printf %s\n $argv' "first line" "second line"
          first line
          second line

       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>:

          fish --init-cmd "source otherfile" script.fish

       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> fish <?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>:

          fish --profile-startup /tmp/start.prof -ic exit
          sort -nk2 /tmp/start.prof

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       fish-doc(1), fish-tutorial(1), fish-faq(1), fish-for-bash-users(1),
       fish-terminal-compatibility(1), fish_indent(1), fish_key_reader(1)

       <?><?><?><?><?><?><?> <?><?><?><?>: <https://fishshell.com>

<?><?> <?><?><?> (COPYRIGHT)
       <?><?><?><?><?><?><?><?><?><?><?><?><?> fish-shell

4.9                            September 7, 2026                       FISH(1)