Adding git branch on the Bash command prompt


I tried adding the git branch I’m currently working on (checked-out) on the bash prompt without success.. (while keeping my current path which shows the active directory/file intact)
I have a .bashrc file on my home, but I also saw many people mentioning the .profile file..


git 1.9.3 or later: use __git_ps1

Git provides a shell script called, which includes a function __git_ps1 that

prints text to add to bash PS1 prompt (includes branch name)

Its most basic usage is:

$ __git_ps1

It also takes an optional format string:

$ __git_ps1 'git:[%s]'

How to Get It

First, copy the file to somewhere (e.g. ~/

Option 1: use an existing copy on your filesystem. Example (Mac OS X 10.15):

$ find / -name '' -type f -print -quit 2>/dev/null

Option 2: Pull the script from GitHub.

Next, add the following line to your .bashrc/.zshrc:

source ~/

Finally, change your PS1 to call __git_ps1 as command-substitution:


PS1='[\[email protected]\h \W$(__git_ps1 " (%s)")]\$ '


setopt PROMPT_SUBST ; PS1='[%[email protected]%m %c$(__git_ps1 " (%s)")]\$ '

git < 1.9.3

But note that only git 1.9.3 (May 2014) or later allows you to safely display that branch name(!)

See commit 8976500 by Richard Hansen (richardhansen):

Both bash and zsh subject the value of PS1 to parameter expansion, command substitution, and arithmetic expansion.

Rather than include the raw, unescaped branch name in PS1 when running in two- or
three-argument mode, construct PS1 to reference a variable that holds the branch name.

Because the shells do not recursively expand, this avoids arbitrary code execution by specially-crafted branch names such as


What devious mind would name a branch like that? 😉 (Beside a Mom as in xkcd)

More Examples

still_dreaming_1 reports in the comments:

This seems to work great if you want a color prompt with xterm (in my .bashrc):

PS1='\[\e]0;\[email protected]\h: \w\a\]\n${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\[email protected]\h\[\033[00m\]:\[\03‌​3[01;34m\]\w\[\033[00m\]$(__git_ps1)\$ ' 

Everything is a different color, including the branch.

In in Linux Mint 17.3 Cinnamon 64-bit:

PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\[email protected]\h\[\033[01;34m\] \w\[\033[00m\]$(__git_ps1) \$ ' 

As noted by J’e in the comments


Modify PS1 assignments in your bashrc with,

PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\[email protected]\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\033[0;32m$(__git_ps1 " (%s)")\033[0m\$ '

# ---AND--- 

PS1='${debian_chroot:+($debian_chroot)}\[email protected]\h:\w$(__git_ps1 " (%s)")\$ '

Answered By – VonC

This Answer collected from stackoverflow, is licensed under cc by-sa 2.5 , cc by-sa 3.0 and cc by-sa 4.0

Leave a Reply

(*) Required, Your email will not be published