gis/README.org
2023-09-21 21:11:57 +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/5a8ebed33da60a18e02718d048ada11b81055836/screenshot.png

Usage

  Usage: gis [OPTIONS] [PATHS] ...

  Show a status summary of all Git repositories in PATHS.
  The colon-seperated environment variable $GIS_PATH is used if no PATH is given.
  If the variable isn't set, the current work directory is used.

  OPTIONS
    -f, --fetch  Execute 'git fetch --prune --all' for all repositories in PATHS
    -p, --pull   Execute 'git pull' for all repositories which are behind upstream
                 in PATHS (includes '--fetch')
    -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.