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


The name of the currently-active git 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]%h [grey]%cd [white]%s [grey]%an[white]"
  dateFormat: "%H:%M %d %b %y"
  enabled: true
    top: 0
    left: 3
    height: 2
    width: 2
  refreshInterval: 8
  - "/Users/chris/go/src/"
  - "/Users/user/fakeapp"


git 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.
dateFormat The format to use when rendering date strings. Any valid Go date layout which is handled by Time.Format. Defaults to Jan 2.
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 git repositories to watch. Zero or more local file paths pointing to valid git repositories.

Keyboard Controls

Key Action
/ Open/close the widget's help modal
c Check out branch
h Show the previous git repository
l Show the next git repository
p Pull repo
r Refresh the data
Show the previous git repository
Show the next git repository

Source Code