FISH_VCS_PROMPT(1)

💅 FISH_VCS_PROMPT(1) — the fish-shell girlies' guide 🐟✨

okay so bestie, welcome to fish_vcs_prompt(1) from the fish-shell manual. this one's short and sweet and honestly kind of iconic — it's the little function that tells your prompt what version control situation you're in. let's get into it 💖

---

✨ NAME ✨

fish_vcs_prompt — outputs version control system info for your prompt to use 🎀

like, it's the vibe-checker for your repo status. no cap.

---

🌸 SYNOPSIS 🌸

fish_vcs_prompt

and here's how you'd actually use it, fr fr:

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

---

🦋 DESCRIPTION 🦋

so fish_vcs_prompt displays info about the current version control system (VCS) repository, if there even is one. if you're not in a repo, it's just gonna be quiet about it. no drama 🌈

the way it works is it calls out to VCS-specific functions — like it's delegating, main character energy only 😌. 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 just does nothing. literally nothing. it's giving respectful silence 💀

⚠️ heads up bestie: the Subversion prompt is disabled by default — because it's slow on large repositories 😭 like, slow slow. to enable it, you modify fish_vcs_prompt to uncomment it. see funced.

for more info, go read the documentation for each of the functions above 👑 iykyk.

---

🎀 EXAMPLE 🎀

a simple prompt that displays all known VCS info — look at her go:

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

---

💜 Copyright 💜

fish-shell developers

---

and that's the whole page, bestie 🫶 no notes, she ate. this was FISH_VCS_PROMPT(1) from the fish-shell manual, version 4.9, dated Sep 08, 2026 — mwah 💋✨