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

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