Show uncommitted, untracked and unpushed changes in multiple Git
repositories. Scan for .git dirs up to DEPTH directories deep.
The default is 2. If DEPTH is 0, the scan is infinitely deep.
mgitstatus shows:
- Uncommitted changes if there are unstaged or uncommitted changes on the
checked out branch. - Untracked files if there are untracked files which are not ignored.
- Needs push (BRANCH) if the branch is tracking a (remote) branch which is
behind. - Needs upstream (BRANCH) if a branch does not have a local or remote
upstream branch configured. Changes in the branch may otherwise never be
pushed or merged. - Needs pull (BRANCH) if the branch is tracking a (remote) branch which is
ahead. This requires that the local git repo already knows about the remote
changes (i.e. you’ve done afetch
), or that you specify the-f
option.
mgitstatus does NOT contact the remote by default. - X stashes if there are stashes.
Since there are a lot of different states a git repository can be in,
mgitstatus makes no guarantees that all states are taken into account.
mgitstatus can also list dirs that are not a repo, if given the -w
switch. To ignore certain repos, set the mgitstatus.ignore
git config flag
for that repo to true
. (See “usage” below for an example).
Usag