Informative git prompt for zsh
zsh prompt that displays information about the current git repository.
In particular the branch name, difference with remote branch, number of files staged, changed, etc.
(an original idea from this blog entry).
The prompt may look like the following:
(master↑3‣1): on branch
master, ahead of remote by 3 commits, 1 file changed but not staged
(status●2): on branch
status, 2 files staged
(master✚7…): on branch
master, 7 files changed, some files untracked
(master✖2✚3): on branch
master, 2 conflicts, 3 files changed
(experimental↓2↑3): on branch
experimental; your branch has diverged by 3 commits, remote by 2 commits
(:70c2952): not on any branch; parent commit has sha1
Here is how it could look like when you are ahead by 4 commits, behind by 5 commits, and have 1 staged files, 1 changed but unstaged file, and some untracked files, on branch
The symbols are as follows:
- Status Symbols
✔: repository clean ●n: there are
✖n: there are
✚n: there are
nchanged but unstaged files
…: there are some untracked files
- Branch Symbols
↑n: ahead of remote by
↓n: behind remote by
↓m↑n: branches diverged, other by
mcommits, yours by
:: when the branch name starts with a colon
:, it means it's actually a hash, not a branch (although it should be pretty clear, unless you name your branches like hashes :-)
Create the directory
~/.zsh/git-promptif it does not exist (this location is customizable).
Move the file
Source the file
~/.zshrcconfig file, and, configure your prompt. So, somewhere in
~/.zshrc, you should have:
source path/to/zshrc.sh # an example prompt PROMPT='%B%m%~%b$(git_super_status) %# '
You may also redefine the function
sourcestatement) to adapt it to your needs (to change the order in which the information is displayed). You may also change a number of variables (which name start with
ZSH_THEME_GIT_PROMPT_) to change the appearance of the prompt. Take a look in the file
zshrc.shto see how this function is defined, and what variables are available.
Go in a git repository and test it!