mgitstatus - Man Page

mgitstatus – Show uncommitted, untracked and unpushed changes for multiple Git repos.

Synopsis

mgitstatus [--version] [-w] [-e] [-f] [--no-X] [-d/--depth=2] [DIR [DIR]...]

Description

mgitstatus shows uncommited, untracked and unpushed changes in multiple Git repositories. By default, mgitstatus scans two directories deep. This can be changed with the -d (--depth) option. If DEPTH is 0, the scan is infinitely deep.

mgitstatus shows:

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.

Options

--version

Show version

-w

Warn about dirs that are not Git repositories

-e

Exclude repos that are 'ok'

-f

Do a 'git fetch' on each repo (slow for many repos)

-c

Force color output (preserve colors when using pipes)

-d,  --depth=2

Scan this many directories deep. Default is 2. If 0, the scan is infinitely deep

You can limit output with the following options:

--no-push

Do not show branches that need a push.

--no-pull

Do not show branches that need a pull.

--no-upstream

Do not show branches that need an upstream.

--no-uncommited

Do not show branches that have unstaged or uncommitted changes.

--no-untracked

Do not show branches that have untracked files.

--no-stashes

Do now show stashes

Examples

The following command scans two directories deep for Git projects and shows their status:

$ mgitstatus 
./fboender/sla: ok 
./fboender/multi-git-status: Needs push (master) Untracked files
./other/peewee: ok 

To scan deeper (three dirs instead of two) in the current dir:

$ mgitstatus -d 3

The following command scans three levels deep in /opt/deploy/ and hides repos that are 'ok'. It does not show stashes:

$ mgitstatus -e --no-stashes -d 3 /opt/deploy

To ignore a repo, set the mgitstatus.ignore git configuration option for that repo to true. E.g.:

$ cd stupidrepo
$ git config --local mgitstatus.ignore true

Authors

Ferry Boender.

Info

Jul 2019