git-recurse-status/README.md

Luzifer / git-recurse-status

Wrapper around git to display status of a whole tree of directories to detect uncommitted or not pushed changes.

Features

• Recurse through a directory tree
• Display changes in a short manner
• Filter output by full-text search
• Filter output by a combinable set of filters
• Change format of output using Go templates

Usage

# git-recurse-status --help
Usage of git-recurse-status:
  -f, --filter stringSlice   Attributes to filter for
      --format string        Output format (default "[{{.U}}{{.A}}{{.M}}{{.R}}{{.D}}{{.S}} {{.State}}] {{.Path}} ({{if .Remote}}{{.Remote}} » {{end}}{{.Branch}})")
      --or                   Switch combining of filters from AND to OR
  -s, --search string        String to search for in output
      --version              Prints current version and exits

Filters

Possible filters:

• By status against the remote:
  • diverged - Local and remote do have different commits
  • ahead - Local has new commits
  • behind - Remote has new commits (remote repository is not automatically fetched!)
  • uptodate - No known changes against remote
• By local changes:
  • untracked - There are files not yet known to git
  • added - Local files are added to the index but not yet committed
  • modified - Local files are modified but not added to the index
  • removed - Local files were removed but not yet deleted from the index
  • deleted - Files are marked to be removed in the index
  • stashed - You have changes in the stash
  • changed - Shortcut for all local changes at once
• Other filters
  • remote - Repositories having a remote named "origin" set

All filters mentioned above are extendable with the prefix no- to negate them (example: no-changes).

Example usage for filters:

# git recurse-status -f no-uptodate
[       →] dockerproxy_config (git@bitbucket.org:luzifer/dockerproxy_config.git » master)
[  M    →] knut-ws (git@github.com:Luzifer/workstation.git » master)

# git recurse-status -f no-uptodate -f modified
[  M    →] knut-ws (git@github.com:Luzifer/workstation.git » master)