Displays information about local mercurial repositories: branch, changed files, and recent commits.


The name of the currently-active mercurial branch.

Changed Files

A list of all the files that have changed since the last commit, and their status.

Recent Commits

A list of n recent commits, who committed it, and when.


  commitCount: 5
  commitFormat: "[forestgreen]{rev}:{phase} [white]{desc|firstline|strip} [grey]{author|person} {date|age}[white]"
  enabled: true
    top: 0
    left: 3
    height: 2
    width: 2
  refreshInterval: 8
  - "/Users/user/fakelib"
  - "/Users/user/fakeapp"


mercurial screenshot


Name Description Value
border Optional Whether or not to draw this widget with a border. Default: true. true, false
commitCount The number of past commits to display. Any positive integer
commitFormat Optional The string format for the commit message.
enabled Optional Whether or not this module is executed and if its data displayed onscreen. Default: false. true, false
focusChar Optional Define one of the number keys as a short cut key to access the widget. 0..9
position Defines where in the grid this module's widget will be displayed.
refreshInterval Optional How often, in seconds, this module will update its data. Default: 300. Any positive integer
repositories A list of Mercurial repositories to watch. A list of zero or more local file paths pointing to valid mercurial repositories.

Keyboard Controls

Key Action
`/` Open/close the widget's help modal
`h` Show the previous Mercurial repository
`l` Show the next Mercurial repository
`r` Refresh the data
`←` Show the previous Mercurial repository
`→` Show the next Mercurial repository

Source Code