| PROMPT_PWD(1) | fish-shell | PROMPT_PWD(1) |
NAME
prompt_pwd - print pwd suitable for prompt
SYNOPSIS
prompt_pwd
DESCRIPTION
prompt_pwd is a function to print the current working directory in a way suitable for prompts. It will replace the home directory with "~" and shorten every path component but the last to a default of one character.
To change the number of characters per path component, pass --dir-length= or set fish_prompt_pwd_dir_length to the number of characters. Setting it to 0 or an invalid value will disable shortening entirely. This defaults to 1.
To keep some components unshortened, pass --full-length-dirs= or set fish_prompt_pwd_full_dirs to the number of components. This defaults to 1, keeping the last component.
If any positional arguments are given, prompt_pwd shortens them instead of PWD <#envvar-PWD>.
OPTIONS
- -d or --dir-length MAX
- Causes the components to be shortened to MAX characters each. This overrides fish_prompt_pwd_dir_length.
- -D or --full-length-dirs NUM
- Keeps NUM components (counted from the right) as full length without shortening. This overrides fish_prompt_pwd_full_dirs.
- -h or --help
- Displays help about using this command.
EXAMPLES
>_ cd ~/ >_ echo $PWD /home/alfa >_ prompt_pwd ~ >_ cd /tmp/banana/sausage/with/mustard >_ prompt_pwd /t/b/s/w/mustard >_ set -g fish_prompt_pwd_dir_length 3 >_ prompt_pwd /tmp/ban/sau/wit/mustard >_ prompt_pwd --full-length-dirs=2 --dir-length=1 /t/b/s/with/mustard >_ echo (prompt_pwd | string split /)[-1] mustard >_ echo (string join / (prompt_pwd | string split /)[-3..-1]) s/with/mustard
Copyright
fish-shell developers
| September 9, 2026 | 4.9 |