Bitbucket is a code hosting site with unlimited public and private repositories. We're also free for small teams!

Close
-*- markdown -*-

hg-prompt
=========

hg-prompt adds an 'hg prompt' command to Mercurial for viewing repository information.  It's designed to be used in a shell prompt.


Requirements
------------

hg-prompt requires Python 2.5+ and (obviously) Mercurial.


Installing
----------

Clone the repository:

    $ hg clone http://bitbucket.org/sjl/hg-prompt/

Edit the `[extensions]` section in your `~/.hgrc` file:

    [extensions]
    prompt = (path to)/hg-prompt/prompt.py


Documentation
-------------

The documentation for hg-prompt is at the [project page][project].  There's a [Quick Start guide][quickstart], [Full Usage Guide][usage], [Keyword List][keywords], and a few other things there.

The documentation is stored in the `docs/` directory of the repository if you prefer to read it offline.

[project]: http://sjl.bitbucket.org/hg-prompt/
[quickstart]: http://sjl.bitbucket.org/hg-prompt/quickstart/
[usage]: http://sjl.bitbucket.org/hg-prompt/documentation/usage/
[keywords]: http://sjl.bitbucket.org/hg-prompt/documentation/keywords/


Questions, Comments, Suggestions
--------------------------------

The code was kind of thrown together in a few nights after I got tired of chaining three or four hg runs together to get what I wanted.  I'm sure it's not perfect, so if you've got a way to improve it please add an issue and let me know.

Patches are also welcome!

Recent activity

Kevin Bullock

Commits by Kevin Bullock were pushed to gvol/hg-prompt

5faf9b0 - bookmarks: check if bookmark is actually current Mercurial doesn't remove the bookmarks.current file when updating away from a bookmark, and repo._bookmarkcurrent() doesn't check whether the ...
Yujie Wu

Commits by Yujie Wu were pushed to gvol/hg-prompt

e16ee63 - Fix compatibility bug for count. `revrange' has been moved into the `scmutil' module since v1.9.
Chris Mansley

Commits by Chris Mansley were pushed to gvol/hg-prompt

91bec91 - Fixed hg help screen for prompt hg help would report "(no help text available)" for the prompt plugin because the package comment was located after ...
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.