Version control information in your prompt.

This project is not under active development. Forks are encouraged!

Download vcprompt, make it executable and add it to your prompt:

$ curl -sL https://github.com/djl/vcprompt/raw/master/bin/vcprompt > ~/bin/vcprompt
$ chmod 755 ~/bin/vcprompt

For bash, you'll want to do something like this:

$ export PS1='\u@\h:\w \$(vcprompt)\$'

ZSH users should be aware that they will have to set the PROMPT_SUBST option first:

$ setopt prompt_subst
$ export PS1='%n@%m:%~ $(vcprompt)$ '

• -f, --format FORMAT

  Passes a custom output format to vcprompt. Defaults to %s:%b. See below for more details.

• -p, --path PATH

  The path on which to run vcprompt. Defaults to the current directory.

• -n, --no-newline

  Do not print a trailing newline character.

• -s, --systems

  Prints all available version control systems to standard out.

• -t, --timeout

  The maximum execution time in milliseconds.

• -h, --help

  Prints the help message and exists.

• -v, --version

  Prints the current version number and exits.

Each version control system also has it's own formatting option. The options take the form of --format-SYSTEM. The available options are currently:

• --format-bzr
• --format-cvs
• --format-darcs
• --format-fossil
• --format-git
• --format-hg
• --format-svn

You can customise the status symbols used with the following options:

• -A, --staged

  The symbol to print when changes have been staged. Defaults to *

• -M, --modified

  The symbol to print when files have been modified. Defaults to +

• -U, --untracked

  The symbol to print when there are untracked files. Defaults to ?

vcprompt comes with a number of formatting tokens. What follows is a list of all the available tokens:

• %s, %n

  The "short name" of the version control system currently in use. E.g. git, hg, svn

• %h

  The hash of the repository. If no hash is available it will show the revision number instead.

• %r

  The revision number of the repository. If no revision number is available it will return the hash instead.

• %b

  The current branch (or basename of the repository if the branch name is unavailable).

• %m

  Displays a plus symbol (+) if there are any changes (which are not staged for commit, in systems that make such a distinction, i.e. git).

• %a

  Displays an asterisk (*) if there are any changes staged for commit (in systems that make such a distinction, i.e. git).

• %u

  Displays a question mark (?) if there are any untracked files.

• %P

  The name of the repository root directory (typically a project name).

• %p

  The relative path from the repository root directory to the current directory (or the directory specified by --path).

• Python 2.4 or later (including Python 3).

• Support for Subversion >= 1.7 and Fossil requires the SQLite3 Python module to be installed (built in on Python 2.5+).

vcprompt was heavily inspired by Greg Ward's original implementation in C.

This version of vcprompt attempts to stay mostly compatible with the original although there may be some notable differences.