OS Manuals

fish_vcs_prompt(1)

fish_vcs_prompt - output version control system information for use in a prompt

FISH_VCS_PROMPT(1) fish-shell FISH_VCS_PROMPT(1)

fish_vcs_prompt - output version control system information for use in a prompt

fish_vcs_prompt

function fish_prompt

printf '%s' $PWD (fish_vcs_prompt) ' $ ' end


The fish_vcs_prompt function displays information about the current version control system (VCS) repository, if any.

It calls out to VCS-specific functions. The currently supported systems are:

  • fish_git_prompt <>
  • fish_hg_prompt <>
  • fish_darcs_prompt <>
  • fish_svn_prompt <>

If a VCS isn't installed, the respective function does nothing.

The Subversion prompt is disabled by default, because it's slow on large repositories. To enable it, modify fish_vcs_prompt to uncomment it. See funced <>.

For more information, see the documentation for each of the functions above.

A simple prompt that displays all known VCS info:

function fish_prompt

...
set -g __fish_git_prompt_showupstream auto
printf '%s %s$' $PWD (fish_vcs_prompt) end


fish-shell developers

October 12, 2026 4.9

fish 4.9.3-r2 · os · ingested 2026-10-13