Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A beautiful and useful prompt for your shell
Latest commit 6db5053 @b-ryan b-ryan release note

A Powerline style prompt for your shell

A Powerline like prompt for Bash, ZSH and Fish:


  • Shows some important details about the git/svn/hg/fossil branch (see below)
  • Changes color if the last command exited with a failure code
  • If you're too deep into a directory tree, shortens the displayed path with an ellipsis
  • Shows the current Python virtualenv environment
  • It's easy to customize and extend. See below for details.

Version Control

All of the version control systems supported by powerline shell give you a quick look into the state of your repo:

  • The current branch is displayed and changes background color when the branch is dirty.
  • When the local branch differs from the remote, the difference in number of commits is shown along with or indicating whether a git push or pull is pending

In addition, git has a few extra symbols:

  • -- a file has been modified, but not staged for commit
  • -- a file is staged for commit
  • -- a file has conflicts

FIXME * A + appears when untracked files are present (except for git, which uses ? instead)

Each of these will have a number next to it if more than one file matches.


This script uses ANSI color codes to display colors in a terminal. These are notoriously non-portable, so may not work for you out of the box, but try setting your $TERM to xterm-256color, because that works for me.

  • Patch the font you use for your terminal: see

    • If you struggle too much to get working fonts in your terminal, you can use "compatible" mode.
    • If you're using old patched fonts, you have to use the older symbols. Basically reverse this commit in your copy
  • Clone this repository somewhere:

    git clone
  • Copy to and edit it to configure the segments you want. Then run

    • This will generate
  • (optional) Create a symlink to this python script in your home:

    ln -s <path/to/> ~/
    • If you don't want the symlink, just modify the path in the commands below
  • For python2.6 you have to install argparse

    pip install argparse

All Shells:

There are a few optional arguments which can be seen by running --help.

  --cwd-mode {fancy,plain,dironly}
                        How to display the current directory
  --cwd-max-depth CWD_MAX_DEPTH
                        Maximum number of directories to show in path
  --cwd-max-dir-size CWD_MAX_DIR_SIZE
                        Maximum number of letters displayed for each directory
                        in the path
  --colorize-hostname   Colorize the hostname based on a hash of itself.
  --mode {patched,compatible,flat}
                        The characters used to make separators between


Add the following to your .bashrc (or .profile on Mac):

    function _update_ps1() {
       PS1="$(~/ $? 2> /dev/null)"

    if [ "$TERM" != "linux" ]; then
        PROMPT_COMMAND="_update_ps1; $PROMPT_COMMAND"


Add the following to your .zshrc:

    function powerline_precmd() {
      PS1="$(~/ $? --shell zsh 2> /dev/null)"

    function install_powerline_precmd() {
      for s in "${precmd_functions[@]}"; do
        if [ "$s" = "powerline_precmd" ]; then

    if [ "$TERM" != "linux" ]; then


Redefine fish_prompt in ~/.config/fish/

    function fish_prompt
        ~/ $status --shell bare ^/dev/null


Adding, Removing and Re-arranging segments

The file defines which segments are drawn and in which order. Simply comment out and rearrange segment names to get your desired arrangement. Every time you change, run, which will generate a new customized to your configuration. You should see the new prompt immediately.

Contributing new types of segments

The segments directory contains python scripts which are injected as is into a single file Each segment script defines a function that inserts one or more segments into the prompt. If you want to add a new segment, simply create a new file in the segments directory and add its name to the file at the appropriate location.

Make sure that your script does not introduce new globals which might conflict with other scripts. Your script should fail silently and run quickly in any scenario.

Make sure you introduce new default colors in themes/ for every new segment you create. Test your segment with this theme first.


The themes directory stores themes for your prompt, which are basically color values used by segments. The defines a default theme which can be used standalone, and every other theme falls back to it if they miss colors for any segments. Create new themes by copying any other existing theme and changing the values. To use a theme, set the THEME variable in to the name of your theme.

A script for testing color combinations is provided at themes/ Note that the colors you see may vary depending on your terminal. When designing a theme, please test your theme on multiple terminals, especially with default settings.



  • virtual_env segment now supports environments made with conda (@ceholden)


  • Fixes for Python 3 compatibility (@b-ryan)


  • The git segment has gotten a makeover (@MartinWetterwald)
  • Fix git segment when git is not on the standard PATH (@andrejgl)
  • Fix --cwd-max-depth showing duplicates when it's <= 2 (@b-ryan)
  • Add padding around exit_code segment (@phatblat)


  • New option (--cwd-max-dir-size) which allows you to limit each directory that is displayed to a number of characters. This currently does not apply if you are using --cwd-mode plain. (@mart-e)


  • New plain mode of displaying the current working directory which can be used by adding --cwd-only plain to This deprecates the --cwd-only option. --cwd-mode dironly can be used instead. (@paol)



  • Use print function for some python3 compatibility (@strycore)


  • The current working directory no longer follows symbolic links
  • New exit_code segment (@disruptek)



Something went wrong with that request. Please try again.