Skip to content

List all the repos, their HEADs and clean status in the Current Directory or the Supplied Directory

License

Notifications You must be signed in to change notification settings

pankajpatel/list-repos

Repository files navigation

List Repos (list-repos)

Code Climate Issue Count Test Coverage

This utility lists the current active branch on repos present in specified directory. By default it takes the current directory

Read more at time2hack.com/introducing-list-repos

To install the utility, simply do

npm install -g list-repos

And in few seconds(or minutes), it should be installed. If it gives error of Access rights, try with sudo and after you enter the password for sudo, it should install normally.

To use the utility, type following on CLI,

# Check for the current active branch on repos present in parent directory
list-repos ../

You can pass the following arguments:

Parameter Shorthand Description
--version -v Version
--help -h Help
--ignore -i Ignore matching substring
--match -m Only matching substring
--gitonly -g Show only git repos
--attention -a Show repos which only needs attention
--simple -s Simple Output
--compact -c Compactness; no value = Low; =s Medium; =so High

And will comeup with this output:

list-repos

There are several other options for output like:

  • --git-only or -g

Show only git repos

list-repos -g

  • --attention or -a

Show all directories which requires attention, includes non-git

list-repos -a

  • --attention --git-only or -ag

Show all git repos which requires attention

list-repos -ag

  • --compact or -c

Show compact table output

list-repos -c

  • --compact=s or -c=s

Show compact table output and short table headers and header description at the bottom

list-repos -c=s

  • --compact=so or -c=so

Show compact table output and short table headers and no header description at the bottom

list-repos -c=so

  • --simple or -s

Show simple comma and new line separated output;

order of values is dir, branch, ahead, dirty, untracked, stashes

list-repos -s

  • --help or -h

Show help

  • --version or -v

Show version of the utility