FISH_HG_PROMPT(1)

✨ FISH_HG_PROMPT ✨

okay so bestie, welcome to the fish_hg_prompt(1) page from the fish-shell gang 💖 this is a little function that spilled the tea on your Mercurial repo, and honestly it's giving main character energy.

---

🌸 NAME 🌸

fish_hg_prompt — literally just spits out Mercurial info so you can flex it in your prompt 💅

---

🎀 SYNOPSIS 🎀

fish_hg_prompt

like, that's it. that's the whole call. no cap. but here's how you'd actually wire it into your prompt, because obviously:

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

---

🦋 DESCRIPTION 🦋

so fish_hg_prompt shows you the deets about the Mercurial repository you're currently standing in — y'know, if there is one. no repo? it's not gonna invent one, bestie. 🙈

heads up tho: Mercurial (hg) has to be installed, or this whole thing is a no-go. it lives over at <https://www.mercurial-scm.org/> btw, iykyk.

by default it only shows the current branch, and that is lowkey on purpose — because hg status can be mad slow on a big repository 😭 nobody wants a laggy prompt, fr fr. you can unlock a more informative prompt by setting the variable $fish_prompt_hg_show_informative_status, like so:

set fish_prompt_hg_show_informative_status

and if you do turn on the informative status, ohhh bestie there are so many customization options, all controlled with fish variables ✨

here's the color squad — these are the colors used when the repo has the respective status:

• $fish_color_hg_clean, $fish_color_hg_modified and $fish_color_hg_dirty

and some colors for the status symbols themselves:

• $fish_color_hg_added
• $fish_color_hg_renamed
• $fish_color_hg_copied
• $fish_color_hg_deleted
• $fish_color_hg_untracked
• $fish_color_hg_unmerged

now for the status symbols themselves, which are fully iconic ngl:

• $fish_prompt_hg_status_added, default '✚'
• $fish_prompt_hg_status_modified, default '*'
• $fish_prompt_hg_status_copied, default '⇒'
• $fish_prompt_hg_status_deleted, default '✖'
• $fish_prompt_hg_status_untracked, default '?'
• $fish_prompt_hg_status_unmerged, default '!'

and finallyyyyy, $fish_prompt_hg_status_order — this one lets you change the order the status symbols show up in 🫶 it defaults to added modified copied deleted untracked unmerged.

also go peep fish_vcs_prompt, which calls all the supported version control prompt functions — git, Mercurial and Subversion included. it's the whole friend group 🌈

---

🐚 EXAMPLE 🐚

a simple prompt that displays hg info, for your viewing pleasure:

function fish_prompt
    ...
    set -g fish_prompt_hg_show_informative_status
    printf '%s %s$' $PWD (fish_hg_prompt)
end

---

👑 COPYRIGHT 👑

copyright belongs to the fish-shell developers 💜

---

and that's the whole vibe check, bestie ✨ this was FISH_HG_PROMPT(1) from fish-shell, version 4.9, dated Sep 08, 2026 — slay, go make your prompt cute now 🎀💅