FISH_BREAKPOINT_PROMPT(1)
π FISH_BREAKPOINT_PROMPT(1) β like, the fish-shell manual, bestie π
okay so real talk, this page lives in the fish-shell manual and it's about one very specific little function. no cap, it's niche but it's iconic.
β¨ NAME β¨
fish_breakpoint_prompt β she defines the prompt that shows up when you're stopped at a breakpoint π
π¦ SYNOPSIS π¦
fish_breakpoint_prompt
which, in the wild, looks like:
function fish_breakpoint_prompt
...
end
πΈ DESCRIPTION πΈ
so fish_breakpoint_prompt is the prompt function that runs when fish is asking you for input in response to a breakpoint command. that's her whole job. main character energy, honestly π«Ά
here's the part you actually need to remember, bestie: the exit status of commands inside fish_breakpoint_prompt will not modify the value of $status outside of the fish_breakpoint_prompt function. literally does not leak. your status is safe. π
fish ships with a default version of this function, and what it does is display the function name and line number of the current execution context. so you always know exactly where you're at. so helpful. we love her. β¨
β EXAMPLE β
a simple prompt that's a simplified version of the default debugging prompt β here it is, verbatim, slay:
function fish_breakpoint_prompt -d "Write out the debug prompt"
set -l function (status current-function)
set -l line (status current-line-number)
set -l prompt "$function:$line >"
echo -ns (set_color $fish_color_status) "BP $prompt" (set_color --reset) ' '
end
π§Ύ Copyright π§Ύ
fish-shell developers π
and that's the whole page, bestie!! nothing more, nothing less, don't let anyone tell you otherwise π
this was FISH_BREAKPOINT_PROMPT(1) from fish-shell, version 4.9, dated Sep 08, 2026 β mwah, go debug something gorgeous π
π₯π
π¦ where this page comes from
- arch rolling: fish 4.9.3-1 Β· GPL-2.0-only AND BSD-3-Clause AND ISC AND MIT AND PSF-2.0
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms