gis/README.org
2023-09-26 13:08:32 +02:00

1.3 KiB

gis

gis is a Bash script which shows a status summary of multiple Git repositories.

It was inspired by wstool, vcstool and the default Starship prompt.

/denis/gis/media/commit/03818ff10e86fff336fa45e06739d530073e8f67/screenshot.png

Usage

  Usage: gis [COMMANDS] [OPTIONS]

  Show a status summary of all Git repositories which are found recursively in
  current work directory. If the colon-separated environment variable $GIS_PATH
  is set, the declared directories will be used instead.

  COMMANDS
    fetch  Execute 'git fetch --prune --all' for all found repositories
    pull   Execute 'git pull' for all found repositories which are behind upstream

  OPTIONS
    -p, --path  PATH  Use PATH for searching Git repositories
    -h, --help        Show this help message and exit

Installation

Place the gis script somewhere in your $PATH or use the provided install.{bash,zsh} scripts. Those will create a symlink in ~/.local/bin and update the respective ~/.{bash,zsh}rc.

Nix Flake

This repository is also a Nix Flake. gis is provided as package under github:Deleh/gis#gis.