Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master

Mercurial plugin


Update .zshrc:

  1. Add name to the list of plugins, e.g. plugins = (..., mercurial, ...) (that is pretty obvious).
  2. Change PROMPT variable of current theme to contain current folder mercurial repo info:

    robbyrussel theme is used by default, so you need to modify PROMPT var from this file by adding $(hg_prompt_info) after $(git_prompt_info), so currently it looks next:

    - PROMPT='${ret_status}%{$fg_bold[green]%}%p %{$fg[cyan]%}%c %{$fg_bold[blue]%}$(git_prompt_info)%{$fg_bold[blue]%} % %{$reset_color%}'
    + PROMPT='${ret_status}%{$fg_bold[green]%}%p %{$fg[cyan]%}%c %{$fg_bold[blue]%}$(git_prompt_info)$(hg_prompt_info)%{$fg_bold[blue]%} % %{$reset_color%}'

    and put modified var at the end of .zshrc.

  3. Initialize additional vars used in plugin. So in short put next in .zshrc:

    ZSH_THEME_HG_PROMPT_DIRTY="%{$fg[magenta]%}) %{$fg[yellow]%}✗%{$reset_color%}"

What's inside?

Adds handy aliases:

  • hgc - hg commit
  • hgb - hg branch
  • hgba - hg branches
  • hgbk - hg bookmarks
  • hgco - hg checkout
  • hgd - hg diff
  • hged - hg diffmerge
pull and update
  • hgi - hg incoming
  • hgl - hg pull -u
  • hglr - hg pull --rebase
  • hgo - hg outgoing
  • hgp - hg push
  • hgs - hg status
  • hgsl - hg log --limit 20 --template "{node|short} | {date|isodatesec} | {author|user}: {desc|strip|firstline}\n"
this is the 'git commit --amend' equivalent
  • hgca - hg qimport -r tip ; hg qrefresh -e ; hg qfinish tip
list unresolved files (since hg does not list unmerged files in the status command)
  • hgun - hg resolve --list

Displays repo branch and directory status in prompt

This is the same as git plugin does.

Note: additional changes to .zshrc are required in order for this to work.


ptrv - original creator

oshybystyi - created this README and know how most of code works

Something went wrong with that request. Please try again.