Skip to content
This repository has been archived by the owner before Nov 9, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


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 > ~/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.


Version control information in your prompt







No packages published