Git-dirs NPM | npm.io

Git Dirs

Run git commands in all git subdirectories

          _   _                 _   _
   __ _  (_) | |_            __| | (_)  _ __   ___
  / _` | | | | __|  _____   / _` | | | | '__| / __|
 | (_| | | | | |_  |_____| | (_| | | | | |    \__ \
  \__, | |_|  \__|          \__,_| |_| |_|    |___/
  |___/

Usage

npm install git-dirs -g

# view
npx git-dirs status -s           # show status of each repo
npx git-dirs branch              # view branches in each repo
npx git-dirs check-ignore        # view ignored files

# update
npx git-dirs fetch               # download objects in each repo
npx git-dirs pull                # pull out of date repos
npx git-dirs clean               # remove ignored files

# other
npx git-dirs xargs <whatever>    # run any command against all child repos

# todo
npx git-dirs checkout [default]  # checkout branch in each repo
npx git-dirs prune               # delete unnecessary local -branches
npx git-dirs clone <project>     # delete unnecessary local -branches

Docs

$ npx git-dirs help

# Usage: git-dirs [options] [command]
#
# Options:
#   -V, --version     output the version number
#   -h, --help        display help for command
#
# Commands:
#   status [options]  show the working tree status
#   help [command]    display help for command

Status

$ npx git-dirs status --help

# show the working tree status
#
# Options:
#   -d, --dir <path>       path other than current directory
#   -s, --short            show statuses in a single line per repo
#   -h, --hide-headers     hide group headers in output
#   -f, --filter <filter>  filter results (choices: "all", "dirty", default: "all")
#   --help                 display help for command

Todo

Automate Deploy w/ Github Actions
Show Progress updates while downloading
Auto Generate --help Docs
Add -i|--interactive flag
Add -r|--recursive flag
Add -f|--force flag

Add Alpha Order (Sort)

.addOption(new Option('-o, --order <sort>', 'sort order').choices(Object.values(StatusOrderTypes)).default(StatusOrderTypes.status))

Add Commands
- checkout # checkout branch in each repo
- prune # delete unnecessary local -0branches
- clean # view ignored files
- clean # remove git ignore

Prior Art

Stack Overflow

Run git pull over all subdirectories (296 ⬆️)
How can I view all the git repositories on my machine? (148 ⬆️)
Managing many git repositories (97 ⬆️)
Find all uncommitted locals repos in a directory tree (26 ⬆️)
How to git pull for multiple repos on windows? (23 ⬆️)
Is there any way to list all git repositories in terminal? (18 ⬆️)
Git Status Across Multiple Repositories on a Mac (18 ⬆️)
How to check the status of all git repositories at once? (9 ⬆️)
Is it possible to do Git status for all repos in subfolders? (5 ⬆️)
Is there any functionality in git to check multiple git repos under a directory? (2 ⬆️)
How do I loop through all of my Git repositories and update them? (6 ⬆️)

Native

git for-each-repo - Run a Git command on a list of repositories

Tools

git-xargs (520 ⭐) - An open source tool to update multiple GitHub repos
multi-git-status (332 ⭐) - Show uncommitted, untracked and unpushed changes for multiple Git repos
git-repo-updater (676 ⭐) - A console script that allows you to easily update multiple git repositories at once
git-summary (73 ⭐) - Summarizes multiple git repository status within a directory
git-status-all (32 ⭐) - Get the status of all git repositories in a directory
Check git status of multiple repos (91 ⭐) - Run git status on each repo under the specified directory